BizNetAI

BizNetAI MCP Server

自然言語によるショッピングクエリを、独立系の販売店のライブストアフロントに振り分け、正規化された商品と販売店の検索結果を返すホスト型のModel Context Protocol サーバーです。販売店ごとに個別の連携を行わずにリアルタイムのコマースデータを必要とする AI エージェントやショッピングアシスタント向けに構築されています。

このリポジトリでは、ホスト型サービスについて説明します。インストールやローカルでの実行は不要です。API キーを使って、以下のエンドポイントを MCP クライアントに設定すれば、ツールを呼び出せます。

---

販売店のカバレッジ

米国とカナダで、18,000 店以上の販売店に対応しており、対象は拡大中です。

現在注力している分野：

skincare · haircare · cosmetics · personal_care · sports_active_wear · clothing · accessories · fine_jewelry · fashion_jewelry · specialty_food · gourmet_food · food_and_beverage · home_decor · home_furnishings · candles_fragrance · wellness · luxury · electronics · consumer_goods · pet · baby_kids

クエリ実行時点での正式な最新一覧を確認するには、list_categories を使ってください。新しい分野は定期的に追加されます。

販売店の最新の対応状況を確認するには find_merchants、完全な販売店ディレクトリ（稼働状況による絞り込みなし）を確認するには list_merchants を使ってください。どちらも定期的に更新されます。

---

エンドポイント

URL	https://biznetaimcp.consumergenie.net/mcp
トランスポート	streamable-http
認証	必須 — すべてのリクエストに Authorization: Bearer <api_key> を指定

サーバーはリクエストごとにステートレスです。事前のセッションハンドシェイクは不要です。

---

API キーの取得

アクセスはセルフサービスで取得できます。

1. メールアドレス、氏名、ユースケースの簡単な説明を添えて申請します。

   curl -X POST https://api.merchant.registration.consumergenie.net/api/developer-keys \
     -H "Content-Type: application/json" \
     -d '{"email": "[email protected]", "name": "Your Name", "reason": "Building an AI shopping assistant"}'
   

2. 承認されると、キー（bnai_live_...）が記載されたメールが届きます。キーは一度だけ表示され、どこにも平文では保存されません。紛失した場合は、新しいキーを申請してください。

各キーには個別のレート制限があります（デフォルトでは毎分 60 リクエスト）。制限を超えると Retry-After ヘッダー付きで 429 が返されます。キーがない場合、無効な場合、または取り消されている場合は 401 が返されます。

---

接続

MCP クライアント（Claude Desktop、Claude Code など）

ほとんどのクライアントは stdio を使用するため、mcp-remote を介して接続し、ヘッダーとしてキーを渡します。

{
  "mcpServers": {
    "biznetai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://biznetaimcp.consumergenie.net/mcp",
        "--header", "Authorization:Bearer ${BIZNETAI_API_KEY}"
      ]
    }
  }
}

生の HTTP

BASE_URL="https://biznetaimcp.consumergenie.net/mcp"
API_KEY="bnai_live_..."

curl -X POST "$BASE_URL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}'

---

ツール

list_categories

BizNetAI の販売店カテゴリの語彙一覧を返します。検索を行う前に、どのような販売店を利用できるかを把握するのに役立ちます。

find_merchants

クエリに一致する稼働中の販売店を検索します。独自の商品検索を行う前に販売店を特定したい場合に便利です。

query    str   required   Natural language search query
country  str   required   ISO country code (e.g. US, CA)
limit    int   0          Max merchants to return (0 = all live matches)

list_merchants

データベースからすべてのアクティブな販売店を一覧表示します。稼働状況の確認やランキングは行わないため、結果は完全で、呼び出すたびに同じです。販売店ディレクトリが必要な場合に使ってください。現在到達可能であることが確認されたエンドポイントが必要な場合は find_merchants を使ってください（応答が遅い販売店は、find_merchants の結果に含まれないことがあります）。一覧に含まれるエンドポイントの一部は、一時的に到達不能な場合があります。

country   str   required   ISO country code (e.g. US, CA)
category  str   omit       One value from list_categories; omit for every category
limit     int   0          Page size (0 = the server page cap, 10,000)
offset    int   0          Skip this many merchants; combine with limit to page

販売店は store_domain 順に並べて返されます。

{
  "store_domain": "naturium.com",
  "store_url": "https://naturium.com",
  "mcp_endpoint": "https://naturium.com/api/mcp",
  "categories": ["skincare"],
  "source_country": "US",
  "last_seen_at": "2026-06-07T02:18:00Z"
}

list_product_varieties

国ごとに利用できる商品バリエーションと、それぞれの結果数を一覧表示します。find_products はクエリを必ずこれらのいずれかに割り当てるため、呼び出す前に、どのような商品検索が成功しそうか、また結果が何件ほど期待できるかを調べるのに役立ちます。

country  str   required   ISO country code (e.g. US, CA)

バリエーションオブジェクトのリストを返します。

{
  "variety": "wireless headphones",
  "product_count": 50
}

バリエーションは国によって異なります。同じ商品タイプでも、別の国では表現の異なるバリエーションに分類されたり、まったく存在しなかったりする場合があります。

find_products

クエリを BizNetAI が厳選した商品カテゴリ（例："wireless headphones"、"vitamin c serum"）と照合し、そのカテゴリですでにランキングされた上位商品を返します。検索前に、ある国で利用可能なカテゴリを確認したい場合は、まず list_product_varieties を呼び出してください。

query    str   required   Natural language product search query
country  str   required   ISO country code (e.g. US, CA)
limit    int   0          Page size (0 = server default)
offset   int   0          Results to skip, for paging beyond the first page

結果数は、マッチしたカテゴリに含まれる商品の数が上限です（通常は約 50 件ですが、ニッチな検索ではそれより少ない場合があります）。この上限を超える offset／limit を指定してもエラーにはならず、残りの結果が返されます。既知のカテゴリにマッチしないクエリの場合は、[] が返されます。

正規化された商品オブジェクトのリストを返します。

{
  "title": "Vitamin C Brightening Serum",
  "description": "...",
  "price_min": 24.60,
  "price_max": 24.60,
  "currency": "USD",
  "available": true,
  "url": "https://merchant.com/products/vitamin-c-serum",
  "image_url": "https://cdn.shopify.com/...",
  "store_domain": "merchant.com",
  "mcp_endpoint": "https://merchant.com/api/mcp",
  "merchant_position": 0,
  "relevance_score": 0.79
}

available は、最後のカタログ更新時点で少なくとも 1 つの商品バリエーションが在庫ありだったかどうかを示します（ブール値のみです。一部の販売業者のバックエンドでは正確な在庫数を取得できません）。relevance_score は類似度スコアです（値が高いほど関連性が高くなります）。しきい値は適用されないため、ユースケースに十分な一致かどうかはご自身で判断できます。

---

レート制限とエラー

ステータス	意味
401	API キーがない、形式が不正、無効、または取り消されている
429	レート制限を超過しました。再試行するタイミングについては Retry-After ヘッダーを確認してください

---

サポート

API に関する質問や問題については、キーの発行を依頼した際に使用したメールアドレス宛てにお問い合わせいただくか、このリポジトリで Issue を作成してください。

ライセンス

MIT