CartScout

CartScout MCP server

Claude、Cursor、または MCP 対応の AI エージェントに、オンラインストアの最新の商品価格、在庫、バリエーション、セール評価を提供します。チャットに商品リンクを貼り、「この価格はお得ですか？」「この3店舗のうち、在庫がある最安の店舗はどこですか？」「サイズ10はありますか？」などと質問できます。

Shopify、WooCommerce、Walmart、eBayのストアで動作し、Amazon はベータ版です。データの取得、ボットフィルター、解析はCartScout APIが処理します。まずはブラウザーで API をお試しください。登録は不要です。

ツール

ツール	エージェントが取得する内容	使用量
get_product	価格、定価と割引、在庫、バリエーション（サイズ、色）ごとの価格と在庫、SKU / GTIN、評価、任意のレビューと商品説明	1回の取得
compare_products	2～10ページを順位付け：最安、在庫ありの最安、最高評価、最大割引、価格差、GTIN による同一商品の特定	URL ごとに1回の取得、PRO プラン以上
check_deal	記録された価格履歴に照らした現在価格のセール評価（平均、最低、最高価格を含む）	1回の取得（refresh: falseの場合は不要）
get_price_history	現在価格、最低価格、最高価格を含む、記録された価格と在庫の変化	取得なし

すべてのツールは読み取り専用で、出力スキーマを備えた構造化 JSON を返します。エージェント向けに応答を簡潔にし、すべてのバリエーション、レビュー、商品説明などの大きなデータは、エージェントが要求した場合にのみ含めます。

セットアップ

1. RapidAPI で CartScout を購読します。無料プランでは月に300回取得できます： プラン。
2. RapidAPI ダッシュボードから X-RapidAPI-Key をコピーします。
3. MCP クライアントにサーバーを追加します。uvで実行され、初回使用時にインストールされます。

Claude Code

claude mcp add cartscout -e RAPIDAPI_KEY=your-rapidapi-key -- uvx cartscout-mcp

Claude Desktop

設定 → 開発者 → 設定を編集し、次を追加します：

{
  "mcpServers": {
    "cartscout": {
      "command": "uvx",
      "args": ["cartscout-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

Cursor

同じ mcpServers ブロックを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加します。

プロンプトの例

• 「https://www.allbirds.com/products/mens-tree-runner-nz-ochre はいくらですか？サイズ10の在庫はありますか？」
• 「このエアフライヤーの79ドルはお得ですか？ https://www.walmart.com/ip/844320666」
• 「この3つの商品リストを比較して、今日購入できる最安のものを教えてください：…」
• 「この商品の過去2週間の価格推移を見せてください。」

CartScout は商品ページを読み取ります。ストアを検索する機能はありません。エージェントに商品 URL を渡すか、先にウェブ検索ツールで探させてください。

設定

変数	デフォルト	用途
RAPIDAPI_KEY	必須	RapidAPI キー
CARTSCOUT_RAPIDAPI_HOST	cartscout-api.p.rapidapi.com	API の RapidAPI ホスト
CARTSCOUT_API_URL, CARTSCOUT_API_KEY	未設定	RapidAPI の代わりに、直接発行された CartScout キーを使用

サーバーは、エージェントが問い合わせた商品 URL のみを CartScout API に送信します。キーがなくても起動してツール一覧を表示します（MCP インスペクターで便利です）。その場合、各ツールの呼び出し時に RAPIDAPI_KEY の追加方法が説明されます。

Docker

docker build -t cartscout-mcp .
docker run -i --rm -e RAPIDAPI_KEY=your-rapidapi-key cartscout-mcp

HTTP トランスポート

cartscout-mcp --transport streamable-http --port 8000 を実行すると、ツールが http://127.0.0.1:8000/mcp で提供されます。接続するすべてのクライアントは環境変数のキーを使用するため、プライベートなアドレスで運用してください。

知っておくとよいこと

• 価格は各ストア独自の地域と通貨に基づいています。
• 結果は最大60分間キャッシュされることがあります（cached: true）。
• 商品を閲覧するにつれて、価格履歴とお買い得度の評価が蓄積されます。初めて表示された商品は、比較できる履歴がほとんどありません。
• 履歴の期間はプランによって異なります。無料プランでは14日間、MEGAでは最大365日間です。
• ストアがリクエストをブロックした場合、ツールはその理由を説明するエラーを返し、失敗したリクエストは課金されません。

開発

uv sync
uv run pytest

ライセンス

MIT