tariff-resolver

tariff-resolver

AI アシスタントを米国輸入関税の調査ツールに変える MCP サーバーです。米国国際貿易委員会（USITC）の公式統一関税表データ（米国政府のパブリックドメイン、35,000 以上の関税品目）を基盤としています。

• 🔍 製品の説明文からHTS コード候補を提示し、CBP CROSS の裁定リンクも提供
• 🧮 輸入総費用の内訳：MFN／FTA 基本税率＋第 99 章の追加関税（IEEPA／第 301 条／第 232 条）＋MPF／HMF 手数料
• 📡 関税変更の追跡：HTS コードをウォッチリストに登録し、HTS 改訂間の税率差分を確認
• 🤖 AI 向けに最適化し、ハルシネーションを抑制：解析済みの税率とともに第 99 章の規則の実際の本文を返すため、LLM は 2024 年頃の数値を作り出すのではなく、実際の例外規定の連鎖に基づいて推論できます

今すぐ必要な理由：デ・ミニミス免税が終了した（2025 年 8 月 29 日）ため、米国向けのすべての貨物で HTS コードと関税の支払いが必要です。さらに、2025～26 年の税率は大統領令によって変わり続けています。

政府機関とは一切関係ありません。出力は通関業者による事前審査向けの候補／推定値であり、通関、法律、税務に関する助言ではありません。推定値にはアンチダンピング税／相殺関税は含まれません。

インストール

Node.js ≥ 18 が必要です。

claude mcp add tariff-resolver -- npx -y tariff-resolver

または、任意の MCP クライアント設定に追加します。

{ "mcpServers": { "tariff-resolver": { "command": "npx", "args": ["-y", "tariff-resolver"] } } }

Claude Desktop（ワンクリック）： Releases から tariff-resolver-<version>.mcpb をダウンロードしてダブルクリックします。ターミナルは必要ありません。

💡 次のプロンプトを試す

• 基本検索： 「男性用の綿 100% T シャツの HTS コードを調べて。」
• 詳細なシナリオ： 「HTS 6109.10.00、原産国は中国、課税価格は 5,000 ドル、海上輸送の場合の関税シナリオを計算して。」
• 調達先の選定： 「ステンレス製の真空フラスコを 1 万ドル分輸入します。中国から調達する場合とベトナムから調達する場合の輸入総費用を比較して。」
• 最新情報の確認： 「商品カタログの関税変更を監視して：6109.10.00、8507.60.00、9617.00.10。」

ツール

ツール	機能
search_hs_candidates	製品の説明文 → 税率と CBP CROSS の裁定リンクを含む上位 HTS 候補
calculate_tariff_scenario	HTS コード＋原産国＋価格（＋重量）→ 基本 MFN／FTA 税率、レイヤーごとの一致度／信頼度を含む第 99 章の追加関税候補、出典付きの適用期限切れの可能性がある関税区分、MPF／HMF を含む構造化 JSON
watch_tariff_changes	HTS コードをローカルのウォッチリストに登録
check_tariff_updates	現行と前回の HTS 改訂を比較し、変更された税率を正確に確認
dataset_info	データ改訂日、行数、出典、ライセンス

設計

サーバーが検索を行い、LLM が推論します。第 99 類のルールは解析済みの adder_pct がある場合はそれを含め、原文のまま返されるため、モデルはブラックボックスの計算を信頼するのではなく、実際の例外チェーンを確認できます。10 桁の統計用細目の税率は、親となる税率行を引き継ぎます。税率表で失効扱い（終了、一時停止、期限切れ）とされている見出しは除外して件数を記録し、ルールに付随する場合は USITC 独自の compiler_note も返します。

ステータスの上書き。 data/status_overrides.json には、税率表には引き続き掲載されているものの、徴収が停止、終了、または一時停止されている第 99 類の見出しを、出典付きでまとめています。エントリーに一致するレイヤーは layers ではなく possibly_expired に返され、エントリーの status、reason、source URL、as_of 日付が含まれます。すべてのエントリーには CBP、Federal Register、または USITC の出典が付いています。エントリーを追加するプルリクエストには、出典を含める必要があります。

データからは分からないこと。 公開されている税率表は、どの時点でも両方向に誤りがあるため、すべての結果に stacking_warning とスナップショットの日付が含まれます。徴収がすでに停止している規定も終了日なしで掲載され続けます。繰り返し見られる例が IEEPA と Section 122 の見出しです。また、新たに布告された措置は、発効から数日後に税率表へ掲載されます。税率表に記載されたすべてのレイヤーを合計しても、実際に課されることのない税率になります。レイヤーは候補として扱い、税率の組み合わせを頼りにする前に、CBP CSMS messages で徴収状況を確認してください。

1 つのコア、2 つの入り口。 すべての関税ロジックは tariff-resolver/core（ファイルシステムにもネットワークにも依存しない純粋な TypeScript）にあります。resolveDuty(dataset, { hts, origin, value_usd?, ocean? }) は、ISO-3166 の alpha-2 コードまたは英語の国名を取る origin を受け取り、基本税率行、個別の MPF/HMF、match と confidence を含む第 99 類の候補レイヤーすべて、出典付きの possibly_expired バケット、スナップショットの日付を返します。MCP ツールから呼び出せるほか、任意の Node またはエッジランタイムからも呼び出せます。認識できない国名を指定すると、部分一致ではなく ORIGIN_UNKNOWN エラーが返るため、原産国名のスペルミスによってレイヤーが少ない税率の組み合わせが誤って解決されることはありません。

データ

USITC の公式 JSON API から取得した HTS の完全なスナップショットが含まれています（米国政府のパブリックドメイン）。いつでも更新できます。

python3 scripts/fetch_hts.py   # ~2 min, fails hard rather than write a partial dataset

dataset_info には、クエリの実行対象となる改訂日が表示されます。

プライバシーポリシー

tariff-resolver はすべてお使いのマシン上で動作し、情報を収集しません。

• データ収集：ありません。クエリ、テレメトリー、分析情報、使用状況データは収集も送信もされません。
• 使用と保存：ウォッチリストはお使いのマシン上のローカル JSON ファイルに保存されます。すべての照会は同梱のローカルデータセットに対して実行されます。
• 第三者との共有：ありません。サーバーは実行時にネットワークリクエストを行いません。（任意の更新スクリプト scripts/fetch_hts.py が接続するのは、公式 USITC API のみです。）
• データの保持：保持するデータはありません。ローカルのウォッチリストファイルはいつでも削除できます。
• お問い合わせ先：[email protected]

ポリシー全文：https://opsloft.dev/privacy

ライセンス

MIT。関税データは米国政府の著作物です（パブリックドメイン）。