全

全球海关贸易数据 Mcp 服务

Name: 全球海关贸易数据 Mcp 服务
Author: topease020

ローカル

github.com/topease020ビジネス・マーケティング12 週間前に更新

リポジトリ

全球海关贸易数据 Mcp 服务について

全球海关贸易数据 MCPはtradee.topease.netに接続し、通関記録の検索や輸入者・輸出者の企業分析を行います。国際貿易の明細や企業単位の情報を必要とするユーザー向けです。

主な機能

01複数条件による通関貿易記録の検索
02輸入者・輸出者企業の検索
03キーワード、役割、HSコード、港の分析
04月別の貿易動向分析
05stdioとStreamable HTTPモード

活用シーン

01企業、製品、HSコード、日付で輸出入記録を検索
02市場内の買い手や供給者を検索
03企業の貿易動向、港、取引相手を分析

MCP 対応

通関記録、輸入者・輸出者の検索、関連企業分析を行う15個のツールをMCPクライアントに公開します。stdioとStreamable HTTPに対応し、API Key認証について記載されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "topease-customs": {
      "command": "uvx",
      "args": [
        "topease-mcp"
      ],
      "env": {
        "TOPEASE_MCP_API_KEY": "<TOPEASE_MCP_API_KEY>"
      }
    }
  }
}

起動コマンドuvx topease-mcp

設定が必要な環境変数

TOPEASE_MCP_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypitopease-mcpstdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

グローバル税関貿易データ MCP

グローバル税関貿易データ MCP サービス — 238 の国・地域をカバーし、輸出入貿易の明細や、バイヤー・サプライヤー企業のプロファイル分析を一元的に検索できます。

概要

全球海关贸易数据 MCP は、tradee.topease.net の税関 AI エージェント貿易データプラットフォームに接続する MCP（Model Context Protocol）サーバーです。税関貿易明細の検索、バイヤー（Importer）／サプライヤー（Exporter）企業の検索に加え、両者を対象にキーワード、貿易上の役割、HS コード、貿易港、貿易動向、取引相手などの多角的な分析を行う 15 個のツールを内蔵し、LLM が実際のグローバル貿易情報データをすばやく取得できるよう支援します。

ご利用前に https://tradee.topease.net/ で登録し、API Key を取得してください。

特長

🌍 グローバルなカバレッジ：238 の国・地域の貿易データを検索できます
🔍 多角的な検索：企業名、製品キーワード、HS コード、貿易期間、輸出入の種類、国を組み合わせて絞り込めます
🔐 セキュアな認証：API Key 認証に対応し、データアクセスを安全に保護します
🚀 2 種類のトランスポートモード：stdio（デスクトップクライアント）と streamable-http（Web アプリ）の 2 種類の実行モードに対応しています
📊 豊富な返却フィールド：企業情報、製品の詳細、貿易額、数量、重量など、完全なデータを含みます
🧭 2 つの主体を対象とする多角的な分析：バイヤー（importer）とサプライヤー（exporter）を対象に、それぞれ 7 個の分析ツールを提供し、キーワード、貿易上の役割、HS コード、港、動向、取引相手などの観点を網羅します

インストール

pip を使用

pip install topease-mcp

uv を使用

uv add topease-mcp

uvx を使用（インストール不要、直接実行）

uvx topease-mcp

ソースからインストール

git clone https://github.com/topease020/topease-customs-mcp-server.git
cd topease-customs-mcp-server
uv pip install -e .

クイックスタート

方法 1：stdio モード（Claude Desktop、Trae などのデスクトップクライアントに推奨）

Claude Desktop、Trae などの MCP クライアントの設定ファイルに以下を追加します。

{
  "mcpServers": {
    "topease-customs-data": {
      "command": "uvx",
      "args": ["topease-mcp"],
      "env": {
        "TOPEASE_MCP_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

または、pip でインストールしたバージョンを使用します。

{
  "mcpServers": {
    "topease-customs-data": {
      "command": "python",
      "args": ["-m", "topease-mcp"],
      "env": {
        "TOPEASE_MCP_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

方法 2：streamable-http モード（Web アプリに推奨）

公開サービスのアドレス

公開の streamable-http サービスを提供しています。以下の設定をそのまま使用できます。

設定項目	値
サービスの種類	ストリーミング可能な HTTP (streamableHttp)
サービス URL	`https://mcp.topease.net/mcp`
リクエストヘッダー	`Authorization=Bearer <your_api_key>`

LLM クライアントでの設定

Claude Desktop、Trae など、streamable-http に対応したクライアントに以下の設定を追加します。

{
  "mcpServers": {
    "【PRO】TOPEASE 贸易数据查询 stream http": {
      "type": "streamableHttp",
      "url": "https://mcp.topease.net/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

API Key の設定について

本サービスでは、次の 2 種類の API Key 設定方法に対応しています（優先順位順）。

環境変数（推奨）：TOPEASE_MCP_API_KEY 環境変数を設定します
HTTP リクエストヘッダー（streamable-http モード）：Authorization: Bearer <your_api_key> リクエストヘッダーで渡します

利用可能なツール

現在、15 個のツールが登録されています。

分類	ツール	説明
税関貿易データ検索	`search_customs_data`	税関貿易明細の検索
バイヤー検索	`search_importer_data`	バイヤー（輸入業者）企業の検索
バイヤー分析	`importer_keyword_analysis`	貿易キーワードの統計
バイヤー分析	`importer_role_analysis`	貿易上の役割の分布
バイヤー分析	`importer_hscode_analysis`	貿易コード（HS Code）の統計
バイヤー分析	`importer_port_analysis`	貿易港の統計
バイヤー分析	`importer_cycle_analysis`	貿易動向（月別統計）
バイヤー分析	`importer_exporter_analysis`	貿易サプライヤー（上流）の一覧
サプライヤー検索	`search_exporter_data`	サプライヤー（輸出業者）企業の検索
サプライヤー分析	`exporter_keyword_analysis`	貿易キーワードの統計
サプライヤー分析	`exporter_role_analysis`	貿易上の役割の分布
サプライヤー分析	`exporter_hscode_analysis`	貿易コード（HS Code）の統計
サプライヤー分析	`exporter_port_analysis`	貿易港の統計
サプライヤー分析	`exporter_cycle_analysis`	貿易動向（月別統計）
サプライヤー分析	`exporter_importer_analysis`	貿易バイヤー（顧客）の一覧

search_customs_data

查询海关贸易数据。支持多维度联合过滤。

参数	类型	必填	说明	默认值
`company_name`	string	否	企业名称（模糊匹配进口商/出口商）	-
`product_keyword`	string	否	产品描述关键字，如 "led"、"valve"	-
`hs_code`	string	否	HS 海关编码（前缀匹配），如 "8415"	-
`trade_type`	string	否	贸易类型：`import`（进口）、`export`（出口）、`all`（全部）	`all`
`country`	string	否	国家/地区名称（中文/英文/ISO编码均可），如 "China"、"美国"、"JP"	-
`date_from`	string	否	起始日期，格式 YYYY-MM-DD	-
`date_to`	string	否	结束日期，格式 YYYY-MM-DD	-
`page_index`	int	否	页码	`1`
`page_size`	int	否	每页记录数（最大 20）	`20`
`sort_by`	string	否	排序字段：`tradedate`、`quantity`、`weight`、`uusd`	`tradedate`
`sort_order`	string	否	排序方向：`asc` / `desc`	`desc`

注意：

company_name、product_keyword、hs_code、country 至少填写一个

page_size 最大值为 20，超出会自动截断

trade_type 映射：import→1, export→0, all→2

返回字段说明

每条记录包含以下字段（中文键名，便于大模型理解）：

字段	说明
`单据ID`	单据编号
`海关编码`	HS 海关编码
`产品描述`	产品描述
`贸易类型`	贸易类型（`进口` / `出口`）
`进口商`	进口商名称
`出口商`	出口商名称
`数量`	数量
`数量单位`	数量单位
`重量`	重量
`金额(USD)`	金额（USD），保留 4 位小数
`贸易日期`	贸易日期
`原产国`	原产国
`原产国ID`	原产国 ID

同时包含分页信息：

字段	说明
`total`	总记录数
`page_index`	当前页码
`page_size`	每页记录数
`total_pages`	总页数

search_importer_data

查询海关数据中的采购商（进口商）企业。支持按产品关键字、HS 编码、企业名称、国家等多维度检索，返回采购商 TCode，可作为后续各 importer_* 分析工具的入参。

参数	类型	必填	说明	默认值
`prodesc`	string	否	产品描述关键字，如 "led"	-
`hs_code`	string	否	HS 海关编码	-
`company_name`	string	否	采购商企业名称关键字	-
`country`	string	否	企业所在国家（中文名/英文名/ISO 编码均可）	-
`from_country`	string	否	采购来源国，如 "China" 表示筛选从中国采购过的采购商	-
`recent_years`	string	否	查询近几年的交易数据，范围 1-5	`"1"`
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`amount`、`count`、`quantity`、`weight`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

注意：prodesc、hs_code、company_name 至少填写一项。

返回字段（records 列表每个元素）：

字段	类型	说明
`TCode`	Encryption	采购商 TCode（唯一标识，用于后续分析工具）
`name`	String	企业名称
`countryId`	Long	企业所在国家 ID
`relatedCount`	Long	相关交易单数
`totalCount`	Long	总交易单数
`maxTradeDate`	String	企业最近贸易时间
`relatedHsCode`	String	关联产品编码
`relatedProduct`	String	关联产品描述

附加注入字段：countryCnName / countryName（企业所在国家中英文名）、fromCountryCnName / fromCountryName（采购来源国中英文名）。

search_exporter_data

查询海关数据中的供应商（出口商）企业。参数结构与 search_importer_data 一致，差异点：to_country 为销售目的国。

参数	类型	必填	说明	默认值
`prodesc`	string	否	产品描述关键字，如 "led"	-
`hs_code`	string	否	HS 海关编码	-
`company_name`	string	否	供应商企业名称关键字	-
`country`	string	否	企业所在国家（中文名/英文名/ISO 编码均可）	-
`to_country`	string	否	销售目的国，如 "United States" 表示筛选销售到美国的供应商	-
`recent_years`	string	否	查询近几年的交易数据，范围 1-5	`"1"`
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`amount`、`count`、`quantity`、`weight`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）： 与 search_importer_data 相同（TCode 为供应商 TCode）；附加注入字段为 countryCnName / countryName、toCountryCnName / toCountryName（销售目的国中英文名）。

importer_cycle_analysis

查询指定采购商的贸易趋势（按月统计）。传入采购商 TCode，按月返回贸易次数、金额、数量、重量、箱量，可用于观察采购商的贸易季节性和周期性变化。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode）。可先通过 `search_importer_data` 工具查询采购商获取	-
`hs_code`	string	否	HS 海关编码前缀过滤	-
`prodesc`	string	否	提单描述关键字，进一步过滤结果	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数，默认 `"12"`（对应 12 个月）	`"12"`
`sort_field`	string	否	排序字段：`tradeDate`、`quantity`、`weight`、`amount`、`count`	`"tradeDate"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`tradeDate`	String	交易月份，如 `"2025-01"`
`teus`	Decimal	贸易总箱量（TEU）
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`quantity`	Decimal	贸易总数量
`weight`	Decimal	贸易总重量

同时包含分页字段：total、pageSize、pageIndex。

importer_keyword_analysis

查询指定采购商的企业关联产品关键字统计，了解该采购商主要采购哪些产品。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode），可通过 `search_importer_data` 获取	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`

返回字段（records 列表每个元素）：

字段	类型	说明
`keyword`	String	关键字
`count`	Long	贸易次数
`countPercent`	Decimal	贸易次数占比

importer_role_analysis

查询指定采购商的贸易角色分布（采购商/供应商）及数据源国家、数据源类型。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode）	-
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`role`	String	贸易角色（采购商/供应商）
`dataSourceCountry`	String	数据源国家，如 "美国,加拿大"
`dataSourceType`	String	数据源类型（进口/出口）
`amount`	Decimal	贸易总金额
`count`	Long	贸易总次数
`amountPercent`	Decimal	贸易金额占比
`countPercent`	Decimal	贸易次数占比

importer_hscode_analysis

查询指定采购商的 HS 编码维度贸易统计，含各维度占比及中英文海关编码描述。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`hsCode`	String	HS 编码
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`teus`	Decimal	贸易总箱量
`weight`	Decimal	贸易总重量
`quantity`	Decimal	贸易总数量
`amountPercent` / `countPercent` / `quantityPercent` / `weightPercent` / `teusPercent`	Decimal	金额/次数/数量/重量/箱量占比
`cnDescription`	String	中文海关编码描述
`enDescription`	String	英文海关编码描述

importer_port_analysis

查询指定采购商的港口维度贸易统计（起运港/卸货港）。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数，最大 `"10"`，超出自动截断	`"10"`
`port_type`	string	否	港口类型：`1` 起运港口，`2` 卸货港口	`"2"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`port`	String	港口名称
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`weight`	Decimal	贸易总重量
`quantity`	Decimal	贸易总数量
`teus`	Decimal	贸易总箱量
`amountPercent` / `quantityPercent` / `countPercent` / `teusPercent` / `weightPercent`	Decimal	金额/数量/次数/箱量/重量占比

importer_exporter_analysis

查询指定采购商的贸易供应商（上游）列表，了解该采购商从哪些供应商采购、各占多少份额。

参数	类型	必填	说明	默认值
`t_code`	string	是	采购商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`TCode`	String	供应商 Tcode
`supplierName`	String	供应商名称
`countryId`	Long	企业所在国家 ID
`teus` / `weight` / `quantity`	Decimal	贸易总箱量 / 总重量 / 总数量
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`amountPercent` / `countPercent` / `quantityPercent` / `weightPercent` / `teusPercent`	Decimal	金额/次数/数量/重量/箱量占比

exporter_cycle_analysis

查询指定供应商的贸易趋势（按月统计）。传入供应商 TCode，按月返回贸易次数、金额、数量、重量、箱量，可用于观察供应商的贸易季节性和周期性变化。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode）。可先通过 `search_exporter_data` 工具查询供应商获取	-
`hs_code`	string	否	HS 海关编码前缀过滤	-
`prodesc`	string	否	提单描述关键字，进一步过滤结果	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数，默认 `"12"`（对应 12 个月）	`"12"`
`sort_field`	string	否	排序字段：`tradeDate`、`quantity`、`weight`、`amount`、`count`	`"tradeDate"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`tradeDate`	String	交易月份，如 `"2025-01"`
`teus`	Decimal	贸易总箱量（TEU）
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`quantity`	Decimal	贸易总数量
`weight`	Decimal	贸易总重量

同时包含分页字段：total、pageSize、pageIndex。

exporter_keyword_analysis

查询指定供应商的企业关联产品关键字统计，了解该供应商主要供应哪些产品。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode），可通过 `search_exporter_data` 获取	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`

返回字段（records 列表每个元素）：

字段	类型	说明
`keyword`	String	关键字
`count`	Long	贸易次数
`countPercent`	Decimal	贸易次数占比

exporter_role_analysis

查询指定供应商的贸易角色分布及数据源国家、数据源类型。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode）	-
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`role`	String	企业角色
`dataSourceCountry`	String	数据源国家
`dataSourceType`	String	数据源类型（进口/出口）
`count`	Long	贸易次数
`amount`	Decimal	贸易总金额
`amountPercent`	Decimal	贸易金额占比
`countPercent`	Decimal	贸易次数占比

exporter_hscode_analysis

查询指定供应商的 HS 编码维度贸易统计，含各维度占比及中英文海关编码描述。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）： 与 importer_hscode_analysis 相同（hsCode、count、amount、teus、weight、quantity、各维度 *Percent、cnDescription、enDescription）。

exporter_port_analysis

查询指定供应商的港口维度贸易统计。与 importer_port_analysis 参数一致，差异点：port_type 默认为 "1"（起运港口，供应商视角）。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数，最大 `"10"`，超出自动截断	`"10"`
`port_type`	string	否	港口类型：`1` 起运港口，`2` 卸货港口	`"1"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）： 与 importer_port_analysis 相同（port、count、amount、weight、quantity、teus、各维度 *Percent）。

exporter_importer_analysis

查询指定供应商的贸易采购商（客户）列表，了解该供应商把货卖给哪些采购商、各占多少份额。

参数	类型	必填	说明	默认值
`t_code`	string	是	供应商 ID（TCode）	-
`prodesc`	string	否	提单描述关键字	-
`hs_code`	string	否	HS 编码	-
`b_date`	string	否	交易起始日期，格式 `yyyy-MM-dd`	-
`e_date`	string	否	交易结束日期，格式 `yyyy-MM-dd`	-
`page_index`	string	否	页码	`"1"`
`page_size`	string	否	每页记录数	`"10"`
`sort_field`	string	否	排序字段：`quantity`、`weight`、`amount`、`count`、`teus`	`"amount"`
`sort_type`	string	否	排序方向：`desc` / `asc`	`"desc"`

返回字段（records 列表每个元素）：

字段	类型	说明
`TCode`	String	采购商 Tcode
`importerName`	String	采购商名称
`countryId`	Long	企业所在国家 ID
`amount`	Decimal	贸易总金额
`teus` / `weight` / `quantity`	Decimal	贸易总箱量 / 总重量 / 总数量
`count`	Long	贸易次数
`amountPercent` / `countPercent` / `quantityPercent` / `weightPercent` / `teusPercent`	Decimal	金额/次数/数量/重量/箱量占比

使用示例

示例 1：按产品关键字查询

请帮我查一下 LED 产品 2025 年从美国的进口数据，前 5 条

大模型将自动调用：

{
  "product_keyword": "led",
  "country": "美国",
  "trade_type": "import",
  "date_from": "2025-01-01",
  "date_to": "2025-12-31",
  "page_index": 1,
  "page_size": 5
}

示例 2：按企业名称查询

查询 IKEA SUPPLY AG 公司 2025 年从美国的出口记录

{
  "company_name": "IKEA SUPPLY AG",
  "country": "美国",
  "trade_type": "export",
  "date_from": "2025-01-01",
  "date_to": "2025-12-31"
}

示例 3：按国家和 HS 编码查询

查询日本 8415 类目下的进口贸易数据

{
  "country": "Japan",
  "hs_code": "8415",
  "trade_type": "import"
}

示例 4：使用 HTTP 请求头传递 API Key（streamable-http 模式）

curl -X POST https://mcp.topease.net/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "name": "search_customs_data",
    "parameters": {
      "product_keyword": "CABIN",
      "page_index": 1,
      "page_size": 10
    }
  }'

示例 5：采购商全维度分析工作流（多工具联动）

帮我分析一下美国的 LED 采购商，并给出其中最大采购商的采购趋势和供应商构成

大模型将依次调用：

// 第 1 步：搜索采购商，获取 TCode
{ "tool": "search_importer_data", "parameters": { "prodesc": "led", "country": "美国" } }

// 第 2 步：查看采购趋势（按月）
{ "tool": "importer_cycle_analysis", "parameters": { "t_code": "<第1步返回的TCode>" } }

// 第 3 步：查看供应商构成
{ "tool": "importer_exporter_analysis", "parameters": { "t_code": "<第1步返回的TCode>" } }

供应商维度同理：先用 search_exporter_data 获取供应商 TCode，再调用 exporter_* 系列分析工具。

开发指南

项目结构

topease-mcp/
├── src/
│   └── topease_mcp/
│       ├── __init__.py                  # 包初始化
│       ├── __main__.py                  # 模块入口：python -m topease_mcp
│       ├── main.py                      # MCP 服务入口：FastMCP 服务器定义、共享鉴权逻辑与工具注册
│       ├── main_stdio.py                # stdio 模式独立入口
│       ├── auth.py                      # API Key 认证模块
│       ├── country.py                   # 238 个国家/地区数据（含 ISO 编码）
│       ├── setting.py                   # 配置项（API 地址、端口）
│       └── mcp_services/                # MCP 服务目录（每个服务 = Service 层 + 工具注册层）
│           ├── customs_search/              # 海关贸易明细搜索（search_customs_data）
│           ├── importer_search/             # 采购商企业搜索（search_importer_data）
│           ├── exporter_search/             # 供应商企业搜索（search_exporter_data）
│           ├── importer_keyword_analysis/   # 采购商-贸易关键字
│           ├── importer_role_analysis/      # 采购商-贸易角色
│           ├── importer_hscode_analysis/    # 采购商-贸易编码
│           ├── importer_port_analysis/      # 采购商-贸易港口
│           ├── importer_cycle_analysis/     # 采购商-贸易趋势
│           ├── importer_exporter_analysis/  # 采购商-贸易供应商
│           ├── exporter_keyword_analysis/   # 供应商-贸易关键字
│           ├── exporter_role_analysis/      # 供应商-贸易角色
│           ├── exporter_hscode_analysis/    # 供应商-贸易编码
│           ├── exporter_port_analysis/      # 供应商-贸易港口
│           ├── exporter_cycle_analysis/     # 供应商-贸易趋势
│           └── exporter_importer_analysis/  # 供应商-贸易采购商
├── pyproject.toml                       # 项目配置与依赖
├── README.md                            # 项目文档
└── .env.example                         # 环境变量示例

每个服务目录包含固定三个文件：__init__.py、<ServiceName>Services.py（Service 层：参数/结果数据模型 + API 请求封装）、<tool_name>.py（工具注册层：注册 MCP 工具并处理鉴权与参数校验）。

核心模块说明

main.py：定义 FastMCP 服务器与共享鉴权逻辑（TOPEASE_MCP_API_KEY、_get_api_key_from_headers、_format_error），各工具注册文件由此导入
mcp_services/：15 个 MCP 工具的实现目录，Service 层封装 API 请求、响应数据模型与字段注释，工具注册层负责参数校验与错误提示
country.py：包含 238 个国家/地区数据，支持通过中文名、英文名、ISO 编码查找国家 ID
auth.py：API Key 验证模块，支持环境变量配置有效密钥列表
setting.py：集中管理 API 基础地址和端口配置

本地开发

# 1. 克隆项目
git clone https://github.com/topease020/topease-customs-mcp-server.git
cd topease-customs-mcp-server

# 2. 安装依赖
uv sync

# 3. 运行测试（如果有）
uv run pytest

# 4. 本地运行
uv run python -m topease_mcp

常见问题

Q: 支持哪些国家/地区？

A: 支持全球 238 个国家和地区，包括主要贸易经济体。可通过中文名、英文名、ISO 2/3 位编码查询。

Q: 数据更新频率是多少？

A: 数据定期更新，具体请参考 topease.net 官网说明。

Q: 如何获取 API Key？

A: 访问 https://tradee.topease.net/ 注册账号即可获取。

Q: 查询有什么限制？

A: API 有请求频率限制，具体限制请查看 API 文档。page_size 最大值为 20。

Q: 为什么工具参数中没有 `api_key`？

A: 为了简化大模型调用，API Key 通过环境变量或 HTTP 请求头配置，不再需要在每次调用时传入参数。

Q: 如何切换 stdio 和 streamable-http 模式？

A: 修改 main.py 中 mcp.run() 的 transport 参数即可：

transport="stdio" — 桌面客户端模式
transport="streamable-http" — Web 应用模式

许可证

MIT License - 详见 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request！

联系方式

官网：https://tradee.topease.net/
PyPI：https://pypi.org/project/topease-mcp/
GitHub：https://github.com/topease020/topease-customs-mcp-server.git

Markdown 対応

ログインしてコメント

基本情報

作者: topease020
トランスポート: stdio
掲載日: 2026年6月9日
最終更新: 2 週間前

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

全球海关贸易数据 Mcp 服务

全球海关贸易数据 Mcp 服务 について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

グローバル税関貿易データ MCP

概要

特長

インストール

pip を使用

uv を使用

uvx を使用（インストール不要、直接実行）

ソースからインストール

クイックスタート

方法 1：stdio モード（Claude Desktop、Trae などのデスクトップクライアントに推奨）

方法 2：streamable-http モード（Web アプリに推奨）

公開サービスのアドレス

LLM クライアントでの設定

API Key の設定について

利用可能なツール

search_customs_data

返回字段说明

search_importer_data

search_exporter_data

importer_cycle_analysis

importer_keyword_analysis

importer_role_analysis

importer_hscode_analysis

importer_port_analysis

importer_exporter_analysis

exporter_cycle_analysis

exporter_keyword_analysis

exporter_role_analysis

exporter_hscode_analysis

exporter_port_analysis

exporter_importer_analysis

使用示例

示例 1：按产品关键字查询

示例 2：按企业名称查询

示例 3：按国家和 HS 编码查询

示例 4：使用 HTTP 请求头传递 API Key（streamable-http 模式）

示例 5：采购商全维度分析工作流（多工具联动）

开发指南

项目结构

核心模块说明

本地开发

常见问题

Q: 支持哪些国家/地区？

Q: 数据更新频率是多少？

Q: 如何获取 API Key？

Q: 查询有什么限制？

Q: 为什么工具参数中没有 api_key？

Q: 如何切换 stdio 和 streamable-http 模式？

许可证

贡献

联系方式

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？

全球海关贸易数据 Mcp 服务について

Q: 为什么工具参数中没有 `api_key`？