Trade Compliance

@pipeworx/trade-compliance

美国进口合规——CBP 海关裁定函（CROSS）和反倾销／反补贴税（AD/CVD）令。无需密钥，无需身份验证。

属于 Pipeworx——一个将 AI Agent 连接到 1679+ 个实时数据源的 MCP 网关。

回答仅靠关税税则无法解答的两个问题：海关此前如何归类这类产品，以及是否对来自这个国家的产品征收贸易救济税。

工具

• cross_search(query, hts?, since?, limit?) — 搜索 CBP CROSS 裁定函，查找关税归类先例。返回裁定编号、日期、主题、指定的 HTS 编号，以及裁定后来是否被修改或撤销。
• cross_ruling(ruling_number, max_chars?) — 获取一份完整的裁定函：事实、CBP 的分析和裁定结论。
• adcvd_orders(product?, country?, hts?, limit?) — 按产品和／或国家查询 AD/CVD 令，按产品与国家组合分组，并显示当前状态和案件编号。
• adcvd_case(case_number | document_number) — 获取已存档的某个 AD/CVD 案件的全部《联邦公报》公告。

身份验证

无需身份验证。两个上游数据源都是美国政府的公开端点，无需密钥或注册。

两件需要特别注意的事

AD/CVD 的适用范围由范围描述决定，而非 HTS 编码。 AD/CVD 公告中的 HTS 编号仅供参考。商品可能在一个看似无关的 HTS 编码下属于适用范围，也可能在一个看似匹配的编码下不属于适用范围。切勿因为没有列出某个 HTS 编码就断定「不适用」——请阅读链接公告中的范围描述。每个 adcvd_orders 响应都会在 scope_note 中注明这一点。

adcvd_orders 报告近期的令相关动态，并非完整清单。 它会按时间倒序搜索最近 100 条匹配的《联邦公报》公告。中国现行的 AD/CVD 令有数百项；仅按国家查询时，只会返回近期有发布令、继续实施或撤销公告的少数条目。对于未找到的结果，应理解为*「未找到近期公告」，而非「不存在相关令」*。每个响应都会附带 coverage_note。

状态值

adcvd_orders 会解析每个产品与国家组合的状态：

状态	含义
in_place	最新行动为发布令、继续实施或修订
in_place_revoked_in_part	商务部已对指定公司或划定的子集撤销该令——对其他所有对象仍然有效
revoked	该令已全部撤销

部分撤销是最常见、也最容易被错误简化的情况：如果将其报告为 revoked，就会让进口商误以为相关税费已不再适用，而实际上他们仍须缴纳。

关于上游数据源的说明

• CROSS 对不存在的裁定编号返回 HTTP 500，而非 404；对于任何未知路径，它还会以 200 状态返回其 SPA 的 index.html。因此，cross_ruling 会再执行一次搜索调用，以区分「不存在此裁定」（reason: ruling_not_found）和真正的服务中断（reason: upstream_error）；每个响应都会解析为 JSON，而不会仅凭状态码判断。
• CROSS 搜索结果包含 tariffs/categories；详情端点则将其返回为 null。 cross_ruling 会合并搜索结果行，确保无论哪种情况都能获得关税编号。
• AD/CVD 案件编号来自《联邦公报》列表端点的 docket_ids——无需逐条获取文档。元素有时是单个代码，有时则是在一个字符串中以逗号连接的多个代码，因此会从连接后的数组中用正则表达式提取代码，而不直接信任单个元素。
• 《联邦公报》全文搜索的噪声较多：查询中提到中国，也可能返回有关日本的公告。系统会从公告标题中解析产品和国家，并根据解析出的值筛选，而非依据查询词。
• 令的类型由案件编号前缀决定（A- 表示反倾销，C- 表示反补贴），而非标题文本——标题中的「Duty」可能同时出现在并列标题（「反倾销和反补贴税令」）中，因此简单的短语匹配会失效。

相关工具包

• hts — 关税税率本身（MFN、FTA 优惠税率、Section 301/232 附加税）。
• sanctions-screening — 受限方和强迫劳动筛查，包括 DHS UFLPA Entity List。
• census-trade、comtrade — 贸易流量。

数据源

• CBP CROSS：https://rulings.cbp.gov/api/search、https://rulings.cbp.gov/api/ruling/<number>
• Federal Register（International Trade Administration 公告）：https://www.federalregister.gov/api/v1/documents.json

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/trade-compliance/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 都连接到同一个网关和相同的 1679+ 个数据源。唯一的区别是直接列出哪个工具包的工具；通过任一 URL，ask_pipeworx 都能访问全部工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/cross_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"lithium ion battery pack","limit":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/cross_search。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

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

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

也可以直接运行以确认它能启动：

npx -y @pipeworx/mcp-trade-compliance

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

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——这在上面的工具包端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Trade Compliance data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT