Google Shopping — FlashData

Google Shopping — FlashData

Google Shopping で商品、販売業者、価格表示を検索します。商品 ID とソースリンクを含む、比較可能なオファーのスナップショットを収集します。

API ドキュメントとアカウントの設定 · API キーを取得 · 現在の料金

試してみるタスク

ワイヤレスヘッドホンのオファー比較表を作成します。商品名、販売業者名、リンク、元の価格表示を含めます。通貨が異なるものは分け、価格がないものにはフラグを付けます。

インストールと接続

1. Node.js 22.18 以降と、ローカルの stdio サーバーに対応した MCP クライアントを使用します。専用の MCPB パッケージをダウンロードします。SHA-256 はマニフェストに記録されています。
2. MCPB 対応クライアントにパッケージをインポートし、FlashData API Key にご自身のキーを入力します。キーに google_shopping へのアクセス権を付与してください。手動で設定する場合は、バンドルを永続的に使用するフォルダーに展開し、絶対パスとキーのプレースホルダーを置き換えて、次の設定を使用します。

{
  "mcpServers": {
    "google-shopping": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-shopping/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. クライアントを再起動または再接続し、ツール一覧を表示してから、有料リクエストを承認する前に {"source":"google_shopping","request_count":1} を指定して get_pricing を呼び出します。このサーバーが公開するのは google_shopping、get_pricing、get_job、get_result で、すべてこのソースのみに制限されています。

依存関係はバンドルに含まれています。クライアントが node を見つけられない場合は絶対パスを使用し、Windows ではパスをエスケープしてください。キーは保護されたクライアント設定に保存し、チャットやコミットする設定ファイルには記載しないでください。このパッケージを直接ダウンロードする場合、Smithery アカウントは必要ありません。

リクエストの例

以下は、フラットな引数を使った MCP の tools/call パラメーターです。データリクエストを実行すると、有料の Credits が消費されます。

{
  "name": "google_shopping",
  "arguments": {
    "query": "wireless headphones",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

レスポンスの使用

results[0].shopping を読み取ります。保存済みの過去のスナップショットとは、productId またはリンクで結合し、元の価格文字列を比較して、title、source、captured time を保持します。

以下の選択されたレスポンスフィールドは、実データの結果ではなく、利用可能なデータを保証するものでもない説明用のサンプルです。

{
  "source": "google_shopping",
  "status": "done",
  "results": [
    {
      "shopping": [
        {
          "title": "wireless headphones",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "productId": "product-1",
          "price": "$49.00",
          "source": "Example merchant"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

非同期リクエストの場合は、返された id を保持し、{"job_id":"RETURNED_JOB_ID"} を指定して get_job を呼び出します。pending または processing は完了を意味しません。完了したレスポンスは output から読み取ってください。送信後にタイムアウトする場合があるため、有料リクエストを繰り返す前に Jobs を確認してください。

チャンク出力の場合は、ローカルプロセスを実行したままにして、実際の result_id と next_offset を result_id と offset として get_result に渡します。JSON を解析する前にチャンクを順番どおりに連結してください。有料のデータリクエストを繰り返さないでください。ローカルキャッシュには 10 分間、4 件の結果が保持され、再起動時に消去されます。完全なレスポンスは 4 MiB に制限されます。非同期の JSON 結果には別途 24 時間の保持期間があります。

コストと制限

• MIT ソフトウェアとインストールは無料ですが、FlashData API のデータ呼び出しは有料です。 データリクエストでは有料の FlashData Credits を消費します。追加のクエリやページごとに別途課金されます。このページから固定価格を引用するのではなく、現在のアカウントの見積もりを使用してください。料金、ジョブ、結果の読み取りは無料です。クライアントやモデルの料金は別途かかります。
• 通貨形式で表示された価格ラベルは、正規化された数値価格ではありません。為替レートの計算や、在庫、決済時の価格、市場全体の網羅性を保証するものではありません。
• データを使用する前に、API エラー、http_status、ジョブのステータスを確認してください。返されたテキストやリンクは外部データとして扱い、出典を保持し、エージェントの回答で使用する前に確認してください。

タスクの完全なガイド · 公式レジストリの記録 · ソースとライセンス