China Customs

@pipeworx/china-customs

中国官方月度货物贸易统计数据——包括进出口总额、贸易差额、按贸易伙伴划分的数据、按 HS 商品类章划分的数据以及贸易指数。数据从海关总署（GACC）的英文版网站抓取；当中国大陆统计数据库（stats.customs.gov.cn）对非中国 IP 地址进行 412 拦截时，该英文网站仍可访问。

属于 Pipeworx 项目的一部分——一个将 AI Agent 接入 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联，未获其认可，也非由其发布。

工具

• china_trade_summary({ month? }) — 以美元和人民币（亿为单位）提供进出口总额和贸易差额，以及海关总署「初步」快报中的官方环比和同比变化百分比。
• china_trade_by_country({ month?, partner? }) — 按贸易伙伴国家/地区列出进出口额和贸易差额，包含当月和年初至今的数据，以及同比百分比，数据来自海关总署「最终」月度发布。partner 是可选的子字符串筛选条件（例如 "United States"、"Japan"、"Asia"）。
• china_trade_by_commodity({ month?, hs_section? }) — 按 HS 类（21 类）和 2 位 HS 章（部）列出进出口额，包含当月和年初至今的数据，以及同比百分比。不提供 hs_section 时，返回总计 + 21 个类；提供该参数时（可使用 2 位 HS 章代码，例如 "84"，或自由文本，例如 "machinery"），还会返回该类下各章的数据。
• china_trade_indices({ month?, direction?, series?, chained?, hs2? }) — 出口或进口的单位价值指数、量指数和价值指数，基期 = 上年同月 = 100。series：hs2（默认）、sitc2、bec、industry、hs4、sitc3。chained 用于选择链式指数版本。传入 2 位 hs2 章代码可查询该章的数据。此海关总署表格中的章/类别名称仅提供中文——可将 HS2 代码与 china_trade_by_commodity 对照，以查找英文名称。
• china_trade_major_commodities({ direction?, month?, commodity?, limit? }) — 海关总署官方英文月度公告表 13（主要出口商品）和表 14（主要进口商品），提供原油、大豆、铁矿石、钢铁、机械、车辆等商品的数量和价值数据，包含当月和年初至今的数据，单位为 1,000 美元，并附有公布的百分比变化。commodity 可按文本筛选；available_months 显示海关总署已发布的月份（英文网站尚未发布的月份，例如最近月份，会报告为不可用，而非猜测数据）。

身份验证

无需密钥。海关总署英文网站（english.customs.gov.cn）无需身份验证即可提供这些页面。

数据源

• http://english.customs.gov.cn/statics/report/monthly.html — “最终”修订版月度报告类别的索引（18 张表，仅含美元数据）：汇总、按国家/地区、按 HS 部分/章、按海关监管方式、主要商品等。
• http://english.customs.gov.cn/statics/report/preliminary.html — “初步”快报表的索引（美元和人民币），发布时间比最终版更早，并包含 GACC 自行计算的环比/同比百分比。
• http://english.customs.gov.cn/statics/report/trade.html — 贸易指数表索引（单位价值/数量/金额、链式和非链式，按 HS2/SITC2/BEC/行业/HS4/SITC3 划分，涵盖出口和进口）。

HTTPS 无法使用 — 在此环境中，网站会在 TLS 连接期间重置连接（已于 2026-09-07 检查）；请使用普通的 http://。

这些表格是真实的 HTML，而非图片或客户端渲染内容 — 这正是本任务最初要确认的问题。使用普通 UA 获取原始 HTML 并解析 <table> 即可证明这一点：GACC 的 monthly.html 报告页（2026 年 7 月）http://english.customs.gov.cn/Statics/ec4779c4-69ac-4c1b-8792-1f2d0f423103.html 直接在标记中包含行 2026.07 | Total 683,366 | Export 397,852 | Import 285,514 | Balance 112,337（单位：百万美元）。

索引页链接到按月划分的报告页，链接无法根据日期推算 — 每个索引表格行都为每个报告类别设有一个单元格；单元格内会为当年迄今已发布的每个日历月各提供一个 <a href> 链接（未链接的 <span>Aug.</span> 而非 <a href>Aug.</a> 表示该月尚未发布）。链接 URL 是不透明的 GUID（/Statics/<uuid>.html），GACC 每次重新发布时都会更改，因此每次工具调用都会重新解析相关索引页（每个隔离环境缓存 6 小时），在获取报告前找到正确链接——无法仅根据月份数字构造报告 URL。

三类报告页的范围和 HTML 布局各不相同：

• monthly.html 中的 “(1) Summary … Monthly” 报告是一个滚动表格——任何一个月份的链接（例如 “Jul.”）都会返回一张包含约 19 个月历史记录的表格（截至此版本，范围为 2025.01 至 2026.07），每个 YYYY.MM 对应一行。其他行（按国家、按 HS 部分等）则是单月快照（当月 + 年初至今）；要获取更早月份的数据，必须使用该月份自己的链接。
• preliminary.html 的表格是每个链接对应一张单月快照，其中包含 GACC 自行计算的环比百分比/同比百分比。数据单元格使用 <span>value</span>。
• trade.html 的索引表格使用另一种从 Word 粘贴而来的 HTML 格式（<td><p>…</p></td>；有时每个单元格包含两行 <p>，用于双语标题），具体部分/章名称仅提供中文——只有数字 HS2 编码可安全用于双语场景。
• preliminary.html 的已链接月份中有时缺少 1 月（GACC 通常会合并报告前两个月的数据，以应对农历新年造成的波动）——不要假设 1–12 月每个月都有链接。

发布延迟：“初步”快报通常在月末约一周后发布；修订后的“最终”数据（china_trade_by_country 和 china_trade_by_commodity 使用此数据）会在 GACC 的下一个月度周期发布。china_trade_summary 的响应始终会注明所读取的实际期间（period_label），每个工具也会列出 available_months——相关 GACC 索引页上当前已链接的日历月份——因此调用方可以了解数据的实际新鲜度，而不必假设数据涵盖截至当月的时间。

请求的月份若超出已链接范围，会明确报错，不会静默替换。 month 始终只按月份数字与索引页匹配（索引页从不注明年份）；实际获取的期间始终从报告页读取并通过 period_label 返回，因此年份猜错会显示为明显的不匹配，而不会导致数据标注错误。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "china-customs": {
      "url": "https://gateway.pipeworx.io/china-customs/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/china-customs/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点会列出约 30 个共享工具，以及该工具包自带的工具。连接的 initialize 响应会说明确切范围，是了解特定日期实际情况的权威依据。

这是有意为之，并非意外的多路复用。这些元工具可以让受限连接回答本工具包未涵盖的问题——通过 ask_pipeworx 路由到整个目录——无需添加第二个 MCP 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的架构定义占用的上下文比路由功能带来的价值更多，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不仅仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1875 多个数据源。唯一的区别在于直接列出哪个工具包的工具；通过任一端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/china_trade_summary \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/china_trade_summary。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "china-customs": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-china-customs"]
    }
  }
}

也可以直接运行，确认其能够启动：

npx -y @pipeworx/mcp-china-customs

它通过 stdin/stdout 使用 MCP，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。源代码相同，工具相同，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的英文提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about China Customs data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT