China Customs

@pipeworx/china-customs

中国の公式月次商品貿易統計です。輸出・輸入・収支の総額、貿易相手国別、HS品目の部・類別、貿易指数を、税関総署（GACC）の英語版サイトからスクレイピングします。中国本土の統計データベース（stats.customs.gov.cn）が中国国外のIPを412でブロックする地域でも、このサイトにはアクセスできます。

Pipeworx の一部です。AI エージェントを1875以上のライブデータソースに接続するMCPゲートウェイです。独立した非公式の連携であり、上流プロバイダーとの提携、承認、または同社による公開はありません。

ツール

• china_trade_summary({ month? }) — GACCの「速報」発表から、公式の前月比・前年同月比（％）を含む、USDおよびCNY（1億単位）の輸出・輸入・収支の総額を取得します。
• china_trade_by_country({ month?, partner? }) — GACCの「確報」月次発表から、月次および年初来の貿易相手国・地域別の輸出・輸入・収支を、前年同月比（％）とともに取得します。partner は任意の部分文字列フィルターです（例："United States"、"Japan"、"Asia"）。
• china_trade_by_commodity({ month?, hs_section? }) — HSの部（21部）および2桁のHS類（区分）別に、月次および年初来の輸出・輸入を、前年同月比（％）とともに取得します。hs_section を指定しない場合は、合計と21部を返します。指定する場合は（"84" のような2桁のHS類コード、または "machinery" のような自由形式のテキスト）、その部に属する各類も返します。
• china_trade_indices({ month?, direction?, series?, chained?, hs2? }) — 輸出または輸入の単価・数量・金額指数を取得します。基準は前年同月＝100です。series：hs2（デフォルト）、sitc2、bec、industry、hs4、sitc3。chained は連鎖指数の形式を選択します。特定の類の詳細を表示するには、2桁の hs2 類コードを指定します。このGACC表の類・部のラベルは中国語のみです。英語名はHS2コードを china_trade_by_commodity で照合してください。
• china_trade_major_commodities({ direction?, month?, commodity?, limit? }) — GACCの公式英語版月次速報の表13（主な輸出品）と表14（主な輸入品）から、原油、大豆、鉄鉱石、鉄鋼、機械、車両などの数量と金額を、月次および年初来で取得します。単位はUS$1,000で、公表された増減率も含まれます。commodity でテキストによる絞り込みができます。available_months にはGACCが公開した月が表示されます（最新月など、英語版サイトでまだ公開されていない月は、推測せず利用不可として報告します）。

認証

キーは不要です。GACCの英語版サイト（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 の 2026 年 7 月分の monthly.html レポートページ（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 という行（百万米ドル）がマークアップに直接含まれています。

一覧ページから月ごとのレポートページにリンクされていますが、リンク先は日付から導き出せません — 各一覧表の行にはレポートカテゴリごとに 1 つのセルがあり、そのセルには、今年これまでに公開された各暦月への <a href> が 1 つずつ含まれています（<a href>Aug.</a> ではなくリンクのない <span>Aug.</span> があれば、その月のデータはまだ公開されていません）。リンク先の URL は不透明な GUID（/Statics/<uuid>.html）で、GACC が再公開するたびに変わります。そのため、各ツール呼び出しではレポートを取得する前に、該当する一覧ページを再解析して適切なリンクを探します（分離環境ごとに 6 時間キャッシュ）。月番号だけからレポート URL を組み立てる方法はありません。

3 種類のレポートページでは、対象範囲も HTML のレイアウトも異なります。

• monthly.html の「(1) Summary … Monthly」レポートは過去に遡る表です。どの月のリンク（例：「Jul.」）を開いても、過去およそ 19 か月分の履歴（このビルド時点では 2025.01 から 2026.07）が、YYYY.MM ごとに 1 行で返されます。その他の表（国別、HS 部別など）は単月のスナップショット（当月と年初来のみ）です。過去の月のデータを取得するには、その月固有のリンクを開く必要があります。
• preliminary.html の表は、リンクごとに単月のスナップショットで、GACC 独自の MoM%／YoY% が組み込まれています。データセルは <span>value</span> です。
• trade.html の一覧表は、Word から貼り付けられた別形式の HTML（<td><p>…</p></td>。セル内に、バイリンガルの見出し用に <p> が 2 行含まれることもあります）を使用しており、個別のセクション名・章名は中国語のみです。バイリンガルで扱えるのは数値の HS2 コードだけです。
• preliminary.html では、リンクされた月から 1 月が欠けていることがあります（GACC は旧正月による変動のため、最初の 2 か月をまとめて報告することがよくあります）。1～12 月すべてにリンクがあると想定しないでください。

公表の遅れ：「速報」版は通常、月末から約 1 週間後に公開されます。改訂後の「確定」値（china_trade_by_country および china_trade_by_commodity で使用）は、GACC の次の月次サイクルで公開されます。china_trade_summary のレスポンスには、実際に読み込んだ対象期間（period_label）が常に記載され、各ツールには、該当する GACC の一覧ページで現在リンクされている暦月を示す available_months が記載されます。これにより、呼び出し元は現在の月が含まれていると想定せず、実際のデータの鮮度を確認できます。

リンクされた期間の範囲外の月をリクエストした場合は、明確なエラーが返され、別の月に黙って置き換えられることはありません。 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 サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が振り分け機能の利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル 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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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