商品ビッグデータサービス

この MCP サービスは、企業キーワード検索、商品検索、企業商品、海外店舗商品、ブランド、EC チャネルの照会機能を提供し、ユーザーの選品、競合調査、商品資格検証、チャネル分析を支援します。

主な機能

• 🏢 企業略称・キーワード検索

• 🔍 小売商品・海外オンラインストア検索

• 🧾 企業の小売商品・EC 商品照会

• 🌍 海外店舗の商品カタログ照会

• 🏷️ 美容業界企業のブランド・製品効能分析

• 🛒 国内・グローバルオンラインストアのチャネル分析

Related MCP server: Enterprise Operation Insight MCP Server

サービス設計の説明

• サービスは実際の利用対象に応じて 6 つの Tool を提供し、上流 API の数に合わせてツールを並べることはしません。

• ユーザーが企業略称のみを提供する場合、まず goods_enterprise_search を使用して企業の正式名称または安定した ID を取得します。

• 企業商品と海外店舗商品にはそれぞれ独立した Tool を提供し、同じパラメータが異なるソースで異なる対象を表すことを避けます。

• goods_enterprise_products は小売商品または EC 商品を選択できますが、1 回の呼び出しでアクセスする Product ID は 1 つのみです。

• 企業の小売商品は 1 ページあたり最大 10 件、その他のページング照会は 1 ページあたり最大 50 件です。

• ページング結果のビジネス外層は total と resultList に統一されています。

• 第三者の商品に依存する店舗の売れ筋、月間売上、累計売上の機能は削除され、価格や売上トレンドの Tool は登録されなくなりました。

• Tool 成功時は、HandaaS Integrator Gateway が抽出したビジネス data を返します。

環境要件

• Python 3.10+

• 依存パッケージ：python-dotenv、requests、mcp

ローカルでのクイックスタート

1. プロジェクトディレクトリに移動

cd goods-mcp-server

2. 仮想環境を作成し依存関係をインストール

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. 環境変数の設定

cp .env.example .env

.env を編集：

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT はオプション設定で、単位は秒、デフォルト値は 30 です。

4. サービスの起動

python server/mcp_server.py streamable-http

サービスのデフォルトアドレスは http://localhost:8000/mcp です。

以下の方法も使用できます：

./start_mcp_server.sh streamable-http

stdio、sse、streamable-http の 3 つの起動方式に対応しています。

5. Cursor / Cherry Studio の設定

{
  "mcpServers": {
    "goods-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

STDIO 版のインストールとデプロイ

{workdir} をプロジェクトの絶対パスに置き換えます：

{
  "mcpServers": {
    "goods-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID、SECRET_ID、SECRET_KEY は、HandaaS にログインしてインテグレーターを登録・開通した後に取得します。実際の認証情報はローカルの .env またはデプロイメントキーにのみ保存してください。

利用可能な Tool と Product ID

1. goods_enterprise_search

機能：企業略称、ブランド、製品、その他のキーワードで候補企業を検索します。

主なパラメータ：

• matchKeyword（必須）：企業略称または関連キーワード。

• pageIndex（オプション）：ページ番号。1 から始まります。

• pageSize（オプション）：デフォルト 10、最大 50。

戻り値：候補企業の total/resultList。企業を確認したら、企業の正式名称、企業 ID、または統一社会信用コードを企業商品・ブランド・チャネルの Tool に優先的に渡します。

2. goods_search

機能：小売商品または海外オンラインストアを検索し、選品、商品発見、越境チャネルの絞り込みに使用します。

主なパラメータ：

• matchKeyword（オプション）：商品名、オンラインストア名、または商品キーワード。

• source（オプション）：retail 小売商品、overseas 海外オンラインストア。デフォルトは retail。

• pageIndex（オプション）：ページ番号。1 から始まります。

• pageSize（オプション）：最大 50。小売検索はデフォルト 10、海外検索はデフォルト 50。

• eshopSource、eshopCategories、eshopSalesLevel（オプション）：海外オンラインストア検索でのみ使用します。

• operationStatus、hasAssociateEnterprise（オプション）：海外オンラインストアのステータスと関連企業の絞り込み。

戻り値：total と resultList。

3. goods_enterprise_products

機能：企業ごとに小売商品または EC 商品を照会します。商品資格検証、企業商品の棚卸し、競合調査に適しています。

主なパラメータ：

• matchKeyword（必須）：企業名、企業 ID、登録番号、または統一社会信用コード。

• productType（オプション）：retail 企業の小売商品、ecommerce 企業の EC 商品。デフォルトは retail。

• keywordType（オプション）：name、nameId、regNumber、または socialCreditCode。

• pageIndex（オプション）：ページ番号。1 から始まります。

• pageSize（オプション）：小売商品は最大 10、デフォルト 10。EC 商品は最大 50、デフォルト 50。

小売商品の戻りフィールド：

• 商品名、商品バーコード、出品日

• 企業名、企業 ID

• ブランド名、GPC 分類

EC 商品の戻りフィールド：

• 商品名、画像リンク、価格、商品の出所

4. goods_overseas_store_products

機能：海外オンラインストア ID で店舗の商品カタログを照会します。

主なパラメータ：

• storeId（必須）：goods_search(source=overseas) が返すオンラインストアの _id。

• pageIndex、pageSize（オプション）：MCP ローカルページング。pageSize は最大 50。

戻り値：商品数、レビュー、BSR、カテゴリ、商品名、リンクなどの情報を返し、total/resultList に統一します。

5. goods_brand

機能：美容業界企業のブランド明細、またはブランド製品の効能概要を照会します。

主なパラメータ：

• matchKeyword（必須）：企業識別子。

• view（オプション）：brand_detail ブランド明細、product_overview 製品効能概要。

• keywordType（オプション）：企業識別子のタイプ。

6. goods_channel

機能：企業の国内 EC 店舗リスト、または国内外オンラインストアの全体明細を照会します。

主なパラメータ：

• matchKeyword（必須）：企業識別子。

• source（オプション）：domestic_store 国内 EC 店舗、global_store 国内外オンラインストア。

• keywordType（オプション）：企業識別子のタイプ。

• pageIndex、pageSize（オプション）：国内店舗のみで使用。pageSize は最大 50。

利用シーン

1. 企業の特定：略称、ブランド、製品キーワードで候補企業と安定した識別子を見つけます。

2. 商品発見：商品キーワードで小売商品を発見したり、商品とプラットフォームで海外オンラインストアを絞り込みます。

3. 企業商品の棚卸し：企業の小売商品のバーコード、ブランド、GPC 分類、EC 商品の価格を照会します。

4. 商品資格検証：企業識別子で商品の主体を特定し、商品名、バーコード、出品情報を照合します。

5. 越境競合調査：海外オンラインストア検索から指定店舗の商品カタログに入り、カテゴリと BSR を分析します。

6. ブランド分析：美容業界企業のブランド、主力製品、製品効能の構成を把握します。

7. チャネル分析：企業の国内 EC 店舗と国内外オンラインストアの構成を比較します。

利用上の注意事項

1. 単一データソース呼び出し：1 回の呼び出しでは、source、productType、view で選択した 1 つの Product ID のみにアクセスします。

2. ページング制限：企業の小売商品は pageSize 最大 10、その他のページングツールは最大 50。

3. 略称の処理：企業略称で直接照会できない場合は、まず goods_enterprise_search を呼び出します。

4. 識別子の優先順位：候補を確認したら、企業 ID または統一社会信用コードを優先的に使用します。

5. 海外店舗 ID：storeId は海外オンラインストアの検索結果に由来する必要があり、企業名で代用することはできません。

6. 空の結果：total=0、resultList=[] は正当なビジネス結果です。

7. 機能の範囲：本サービスは、店舗の売れ筋、月間売上額、累計販売数、売上トレンドの照会を提供しません。

利用質問の例

goods_enterprise_search

1. 「小米」に対応する企業はどれですか？

2. 「格力」を通じて正確な企業名と企業 ID を見つけてください。

goods_search

1. 小売市場のコーヒー商品を検索して、最初の 10 件を見せてください。

2. coffee を販売する 亚马逊 の海外オンラインストアを検索してください。

goods_enterprise_products

1. 小米科技有限责任公司の小売商品の名称、バーコード、ブランドを照会してください。

2. ある企業が EC プラットフォームで公開している商品の名称、価格、出所を確認してください。

goods_overseas_store_products

1. この海外オンラインストアの商品カタログと BSR を確認してください。

2. 指定した海外店舗の商品とレビュー数をページングで一覧表示してください。

goods_brand

1. 上海家化联合股份有限公司のブランド明細を照会してください。

2. 欧莱雅（中国）有限公司のブランド製品の効能概要を分析してください。

goods_channel

1. 珠海格力电器股份有限公司にはどのような国内 EC 店舗がありますか？

2. 北京京东世纪贸易有限公司は国内外にどのようなオンラインストアチャネルがありますか？

テスト検証

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

単体テストは Mock HTTP レスポンスを使用し、実際の HandaaS 商品 API を呼び出しません。