Trade Compliance

@pipeworx/trade-compliance

米国の輸入コンプライアンス — CBP の税関裁定書（CROSS）およびアンチダンピング／相殺関税（AD/CVD）命令。キー不要、認証不要です。

Pipeworx の一部です — AI エージェントを 1679 以上の稼働中のデータソースに接続する MCP ゲートウェイです。

関税表だけでは答えられない 2 つの問いに答えます。税関はこれまでこの製品をどのように分類してきたか、そして この国からの製品に対する貿易救済関税はあるか。

ツール

• cross_search(query, hts?, since?, limit?) — CBP CROSS の裁定書を検索し、関税分類の先例を調べます。裁定番号、日付、対象、割り当てられた HTS 番号、および裁定が後に修正または撤回されたかどうかを返します。
• cross_ruling(ruling_number, max_chars?) — 1 件の裁定書全文を取得します。事実関係、CBP の分析、裁定内容が含まれます。
• adcvd_orders(product?, country?, hts?, limit?) — 製品および／または国別に AD/CVD 命令を検索し、製品と国の組み合わせごとに、現在のステータスと案件番号をまとめて返します。
• adcvd_case(case_number | document_number) — 1 件の AD/CVD 案件について、登録されているすべての Federal Register 通知を取得します。

認証

不要です。どちらの上流サービスも、キーや登録が不要な米国政府の公開エンドポイントです。

注意すべき 2 つの点

AD/CVD の適用範囲は HTS コードではなく、適用範囲に関する文言で決まります。 AD/CVD 通知に記載されている HTS 番号は、参考として示される相互参照にすぎません。一見無関係に見える HTS コードでも対象となる場合があり、逆に該当しそうな HTS コードでも対象外となる場合があります。HTS コードが記載されていないことを理由に「対象外」と判断しないでください。リンク先の通知にある適用範囲の文言を確認してください。すべての adcvd_orders 応答には、これが scope_note として含まれます。

adcvd_orders が報告するのは最近の命令関連の動きであり、全件の一覧ではありません。 一致する Federal Register 通知のうち、最新のものから 100 件を検索します。中国には数百件の AD/CVD 命令が発令されています。国のみを指定したクエリでは、最近の命令、継続、または撤回に関する通知がある一部の案件だけが返されます。結果にない場合は「最近の通知が見つからなかった」と捉え、「命令が存在しない」と判断しないでください。すべての応答には coverage_note が含まれます。

ステータス値

adcvd_orders は、製品と国の組み合わせごとにステータスを判定します。

status	意味
in_place	最新の措置は命令、継続、または修正です
in_place_revoked_in_part	商務省は指定企業または適用範囲から除外された一部について命令を撤回しました — それ以外のすべての対象には引き続き適用されます
revoked	命令は全面的に撤回されました

部分的な撤回はよくあるケースであり、単純化すると危険です。これを revoked として報告すると、実際には引き続き適用される関税がなくなったと輸入業者に伝えてしまうことになります。

上流サービスに関する注意事項

• CROSS は存在しない裁定番号に対して HTTP 500 を返します（404 ではありません）。また、未知のパスに対して SPA の index.html を 200 で返します。 そのため cross_ruling は 2 回目の検索呼び出しを行い、「該当する裁定がない」（reason: ruling_not_found）場合と実際の障害（reason: upstream_error）を判別します。また、すべての応答をステータスだけで信頼せず、JSON として解析します。
• CROSS の検索結果には tariffs／categories が含まれますが、詳細エンドポイントでは null が返されます。 cross_ruling は検索結果をマージするため、どちらの場合も関税番号を取得できます。
• AD/CVD の案件番号は Federal Register の一覧エンドポイントにある docket_ids から取得します。 文書ごとの取得は不要です。要素には単一のコードが含まれる場合と、1 つの文字列に複数のコードがカンマ区切りで含まれる場合があるため、要素ごとの内容をそのまま信頼せず、結合した配列から正規表現でコードを抽出します。
• Federal Register の全文検索結果にはノイズが含まれます。 中国に言及するクエリで日本に関する通知が返されることがあります。製品と国は通知の タイトル から解析し、クエリ語ではなく、解析した値に基づいて絞り込みます。
• 命令の種類は、タイトルの文言ではなく案件番号の接頭辞から判定します（A- はアンチダンピング、C- は相殺関税）。タイトルでは「Antidumping and Countervailing Duty Orders」のように「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 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも 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