海关数据分析专家

基于海关进出口数据，提供多维度的贸易分析服务。通过调用后端API获取数据，支持三大类查询、14种分析维度。

配置

{
  "skills": {
    "entries": {
      "h_smtso_com": {
        "config": {
          "api_base_url": "https://h.smtso.com/skill/customs",
          "timeout": 30000
        }
      }
    }
  }
}

• api_base_url: 海关数据API服务器地址（必填）
• timeout: 请求超时时间，默认30000ms

国家代码

API 端点与参数

1. HS编码/产品名称查询

端点: POST {api_base_url}/queryHsCodeProductSkill

参数:

返回数据字段:

• PurchaseDetaiList: 采购明细列表
• importer_count: 采购商数量
• sum_amount: 总金额
• purchase_product_count: 采购记录数
• Top10ImporterList: 前十采购商列表
• Top3ExporterList / Bottom3ExporterList: 供应商分层
• Top5SalesCountryList: 前五销售国家
• DatePurchaseList: 月度采购趋势

2. 采购商查询

端点: POST {api_base_url}/queryImporterSkill

参数:

3. 供应商查询

端点: POST {api_base_url}/queryExporterSkill

参数:

使用方式

通过 fetch 调用 API

使用 Node.js fetch 或 curl 进行 POST 请求，Content-Type 为 application/x-www-form-urlencoded;charset=UTF-8。

示例: 查询HS编码8517在美国的市场概览

curl -X POST "{api_base_url}/queryHsCodeProductSkill" \
  -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \
  -d "dataarea=1&importercountrytag=us&hs_code_product=8517&StartDate=2025-01-01&EndDate=2025-12-31"

示例: 查询 Walmart 的采购行为分析

curl -X POST "{api_base_url}/queryImporterSkill" \
  -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \
  -d "dataarea=2&importercountrytag=us&importer=Walmart&StartDate=2025-01-01&EndDate=2025-12-31"

使用 Python

import urllib.parse, urllib.request

data = urllib.parse.urlencode({
    "dataarea": "1",
    "importercountrytag": "us",
    "hs_code_product": "8517",
    "StartDate": "2025-01-01",
    "EndDate": "2025-12-31"
}).encode()

req = urllib.request.Request(f"{api_base_url}/queryHsCodeProductSkill", data=data)
resp = urllib.request.urlopen(req)
result = resp.read().decode()

条件与限制

• 需要在配置中正确设置 api_base_url
• 后端API必须是可达的HTTP服务
• 返回数据格式为JSON
• HS编码支持前缀匹配（如"8517"匹配所有8517开头的编码）
• 产品名称支持全文匹配
• 默认不设置日期时，自动查询近一年的数据
• 默认国家为美国（us）