shopdata

shopdata

shopdata は、JSON 形式で公開 Amazon データを返す HasData Amazon MCP サーバーへの小規模なローカルブリッジです。ASIN を渡すと、その商品の詳細またはカスタマーレビューを取得します。キーワードを渡すと、指定した Amazon ドメインで検索します。販売者 ID を渡すと、その販売者の公開ストアフロントプロフィール、または販売者が提供するカタログを返します。

このブリッジは Amazon データを独自に保持しません。ライブエンドポイントから取得したとおりの上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得したインターフェースは読み取り専用です。購入、チェックアウト、アカウントに関するツールは含まれていません。

ツール

• hasdata_amazon_product_getProductDetails — ASIN で商品ページを1件取得します。必須：asin。任意：domain、language、deliveryZip、shippingLocation、otherSellers（他の販売者のオファー欄も取得します）。
• hasdata_amazon_reviews_getProductReviews — ASIN のページ分割されたカスタマーレビューを取得します。必須：asin。任意：domain、language、page、searchTerm、reviewerType、stars、format、mediaType、sortBy。
• hasdata_amazon_search_getSearchResults — 指定した Amazon ドメインでキーワード検索します。必須：q。任意：domain、language、page、deliveryZip、shippingLocation、sortBy。
• hasdata_amazon_seller_getSellerDetails — 販売者の公開ストアフロントプロフィールを取得します。必須：sellerId。任意：domain、language。
• hasdata_amazon_seller_products_getSellerProducts — 販売者が提供するページ分割されたカタログを取得します。必須：sellerId。任意：domain、language、page。

設定

• HASDATA_AMAZON_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=amazon で、クエリー文字列も含みます。（この上書き用フックは、この再構築で独自に明記したものです。）
• HASDATA_API_KEY（任意）— 設定すると、すべての上流リクエストに、呼び出し元自身の HasData API キーを含む x-api-key: <key> ヘッダーが付加されます。設定されていない場合、キーのヘッダーは送信されません。どちらの場合も Authorization ヘッダーは送信されません。（環境変数名とヘッダー名は元のレジストリ記録に基づいて固定されています。この環境変数からキーを転送する仕様は、この再構築で独自に明記したもので、元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo の name は shopdata）を送り、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize に対して Mcp-Session-Id ヘッダーを返した場合、その値は以降のすべてのリクエストに付加され、プロセスの終了までセッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま渡されます。失敗（JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、または完了できないリクエスト）は、テキストが shopdata error: で始まる isError 結果として返されます（このエラー表示は、この再構築で独自に明記したものです）。

CLI

各ツールは、1つの JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/shopdata hasdata_amazon_product_getProductDetails '{"asin":"B07FZ8S74R"}'
npx @reneturcios/shopdata hasdata_amazon_search_getSearchResults '{"q":"noise cancelling headphones","sortBy":"priceLowToHigh"}'
npx @reneturcios/shopdata --version

終了コード：成功時は 0、isError の結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/shopdata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "shopdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/shopdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/shopdata
docker run --rm ghcr.io/cloudcorprecords/shopdata --version

コンテナのデフォルトコマンドは mcp です。そのため、最初の形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは、すべてスタブ化された JSON-RPC 上流サーバーに対して実行されます。ライブネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。