Brazil Comex Stat

@pipeworx/brazil-comex-stat

ブラジルの月次貿易統計です。NCM8 製品コード、相手国、ブラジルの州ごとの輸出入データを、MDIC Comex Stat からリアルタイムで中継します。

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

ツール

• br_trade_flows(flow, ncm?, chapter?, country?, state?, from, to, monthly?) — 期間内の輸出入額（USD FOB）と重量（kg）を取得します。製品（NCM8 コードまたは 2 桁の章）、相手国、ブラジルの州で絞り込めます。コードはすべてレスポンス内で名称に解決されます。
• br_trade_top_partners(flow?, ncm?, chapter?, year, limit?) — 指定した年の、製品別（または全体）の上位相手国を金額順に取得します。
• br_trade_top_products(flow?, country, year, limit?) — 指定した年にブラジルが特定の国と取引した上位の NCM 章を金額順に取得します。

認証

認証キーは不要です。上流 API は公開されており、認証も不要ですが、レート制限があります（観測値：特定の IP アドレスからはおよそ 10 秒に 1 回のリクエスト）。MDIC Comex Stat: 429 ... が返された場合、ツール呼び出しで再試行が必要になることがあります。

データソース

MDIC Comex Stat — ブラジルの公式貿易統計システムで、Ministério do Desenvolvimento, Indústria, Comércio e Serviços（MDIC）が運営しています。統計値はブラジルの税関申告（Receita Federal）に基づき、毎月公開されています。このパックはリクエストごとに MDIC 独自のライブクエリ API を呼び出します。貿易統計をダウンロード、複製、保存することはありません。各レスポンスは上流 API への最新の呼び出しから生成され、その呼び出し時刻が data_as_of に設定されます。MDIC のデータはブラジルのオープンガバメントデータ方針（Lei de Acesso à Informação, Lei 12.527/2011）に基づいて公開されています。統計値の出典として MDIC / Receita Federal を明記してください。

このパックが、すでにブラジルを対象としている comtrade（UN Comtrade）と併存する理由：Comtrade が報告するブラジルのデータは HS6 で、年次集計かつ公開まで数か月の遅れがあります。Comex Stat はブラジル独自の税関データで、HS6 より細かい国内の 8 桁関税コード NCM8 に基づき、月次で公開され、原産地または仕向地のブラジルの州別にも分類されています。Comtrade にはこの分類がありません。

国名は MDIC 独自の（ポルトガル語の）国リストと照合され、主要な貿易相手国については一般的な英語の別名（例：「USA」、「South Korea」、「UK」）も使えます。ブラジルの州は正式名称または 2 文字の UF 略称（例：「Mato Grosso」または「MT」）で指定できます。NCM 製品コードには 8 桁の完全なコードが必要です。NCM/HS の章は 2 桁です（例：「12」＝油糧種子および穀物。ブラジル最大の輸出品である大豆も含まれます）。

MDIC 独自のテーブルで解決できないコード、国名、州名を指定した場合は、解決できなかった項目を示すエラーが発生します。空の結果が黙って返されることはありません。ただし、指定期間の取引が実際にゼロである有効な NCM/章コードの場合は、稼働中の上流 API から正しく取得された結果であるため、row_count: 0、または空の rows／top_partners／top_products 配列が返されます。これは失敗ではありません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "brazil-comex-stat": {
      "url": "https://gateway.pipeworx.io/brazil-comex-stat/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/brazil-comex-stat/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/br_trade_flows \
  -H 'Content-Type: application/json' \
  -d '{"flow":"export","ncm":"12019000","country":"China","from":"2025-01","to":"2025-12"}'

最初の呼び出しにアカウントは不要です。任意のツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/br_trade_flows を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "brazil-comex-stat": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-brazil-comex-stat"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-brazil-comex-stat

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Brazil Comex Stat data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT