kwery

kwery MCP サーバー

Amazon、Google Shopping、Idealo、eBay、Kaufland などの最新価格、販売情報、信頼スコアを、AI アシスタント用のツールとして利用できます。たとえば 「ドイツで GTIN 4006381333962 が最も安いのはどこですか？」 と自然な言葉で尋ねると、アシスタントがマーケットプレイスをリアルタイムで検索します。

kwery はホスト型のリモート MCP サーバーです。インストールは不要です。クライアントに以下の URL を設定し、API キーを送信してください。

サーバー URL	https://api.kwery.co/mcp
トランスポート	Streamable HTTP
認証	x-api-key ヘッダーの kwy_live_ API キー（または Authorization: Bearer）
レジストリ	公式 MCP レジストリの co.kwery/price-data
ガイド全文	docs.kwery.co/guides/mcp

API キーを取得する： kwery.co で登録してください。無料プランのクレジットも MCP で利用できます。

接続

kwy_live_... をご自身のキーに置き換えてください。

Claude Code

claude mcp add --transport http kwery https://api.kwery.co/mcp \
  --header "x-api-key: kwy_live_..."

すべてのプロジェクトで使用するには、--scope user を追加してください。

Claude（claude.ai および Claude Desktop）

Customize → Connectors → + Add → Add custom connector

1. 名前に kwery、URL に https://api.kwery.co/mcp を入力し、Continue を選択します。
2. 認証：No sign-in。Claude が「Sign in now」を Detected と表示する場合がありますが、kwery では代わりに以下の API キーヘッダーを使用します。
3. Add header：名前に x-api-key、値にご自身のキーを入力し、Required にチェックを入れます。その後、Add を選択します。

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（すべてのプロジェクト）：

{
  "mcpServers": {
    "kwery": {
      "url": "https://api.kwery.co/mcp",
      "headers": { "x-api-key": "${env:KWERY_API_KEY}" }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "inputs": [
    { "type": "promptString", "id": "kwery-api-key", "description": "kwery API key", "password": true }
  ],
  "servers": {
    "kwery": {
      "type": "http",
      "url": "https://api.kwery.co/mcp",
      "headers": { "x-api-key": "${input:kwery-api-key}" }
    }
  }
}

その他のクライアント

カスタムヘッダーを使った Streamable HTTP 経由のリモート MCP サーバーに対応するクライアントであれば、https://api.kwery.co/mcp を指定し、x-api-key を送信してください。

ツール

ツール	用途	コスト
get_product_offers	1つのマーケットプレイスにおける1つの商品の価格、販売情報、信頼スコア	データソースのクレジットレート
compare_prices	最大5つのマーケットプレイスにおける1つの商品の価格を比較し、価格順に表示	結果を返したデータソースの合計
submit_batch	1つのマーケットプレイスに対し、最大1,000件の識別子をバックグラウンドジョブとして送信	事前見積もりが必要。結果ごとに課金
get_batch_status	バッチジョブの進行状況	無料
get_batch_results	完了したジョブの結果をページ単位で取得	無料
list_sources	マーケットプレイス、国、識別子の種類、クレジットレート	無料
get_account	プラン、クレジット残高、使用済みクレジット	無料

識別子：GTIN/EAN、ASIN（Amazon）、マーケットプレイス独自の商品 ID、対応している場合は PZN。 プロンプト price_check と catalog_sweep、およびリソース kwery://sources が含まれています。

lowest_price は、送料込みで最も安い、新品かつ在庫のある販売情報を示します。すべての結果に信頼スコアが付与されます。0.7 未満の場合は、実行に移す前に人が確認してください。

プロンプトの例

• 「ドイツで GTIN 4006381333962 が今いちばん安いのはどこですか？」
• 「ドイツの Amazon で ASIN B08R57HZ4Z は送料込みでいくらですか？」
• 「この200件の GTIN を Kaufland DE で検索してください。まずクレジットの見積もりを表示してください。」
• 「kwery のクレジットはあといくつ残っていますか？」

料金と制限

MCP の呼び出しでは、kwery API と同じクレジットを使用します。キャッシュされた結果と検索に失敗した場合は無料です。検索は最大50秒間待機します。販売情報の読み込みが続いている場合、アシスタントは取得済みの情報を返し、残りは後から取得できます。詳しくはガイドをご覧ください。

サポート

kwery.co · docs.kwery.co

このリポジトリには、サーバーのドキュメントとレジストリのメタデータが含まれています。サーバー自体は kwery がホストしています。