CartScout

CartScout MCP 服务

让 Claude、Cursor 或任何兼容 MCP 的 AI Agent 获取网店的实时商品价格、库存、变体和优惠评分。将商品链接粘贴到聊天中，然后询问“这个价格划算吗？”、“这三家店中哪家最便宜且有货？”或“有 10 码的吗？”

适用于 Shopify、WooCommerce、Walmart 和 eBay 商店，Amazon 目前处于测试阶段。数据来自 CartScout API，由它负责获取、过滤机器人流量并解析数据。可以先在浏览器中试用 API，无需注册。

工具

工具	Agent 可获取的信息	用量
get_product	价格、标价和折扣、库存、变体（尺码、颜色）及其各自的价格和库存、SKU / GTIN、评分，可选的评价和商品描述	1 次提取
compare_products	对 2-10 个商品页面进行排名：最便宜、有货商品中最便宜、评分最高、折扣最大、价格范围，以及按 GTIN 匹配的同款商品	每个 URL 1 次提取，需 PRO 计划或更高等级
check_deal	当前价格相对于记录历史价格的优惠评分，包含平均价、最低价和最高价	1 次提取（或设置 refresh: false 时无需提取）
get_price_history	已记录的价格和库存变化，包含当前价、最低价和最高价	无需提取

所有工具均为只读，并返回带有输出架构的结构化 JSON。响应内容经过精简，便于 Agent 使用：仅当 Agent 请求时，才会包含所有变体、评价和商品描述等较大的数据部分。

设置

1. 在 RapidAPI 上订阅 CartScout。免费计划每月包含 300 次提取： 计划。
2. 从 RapidAPI 控制面板复制你的 X-RapidAPI-Key。
3. 将服务添加到客户端。它使用 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（单个项目）。

示例提示词

• “https://www.allbirds.com/products/mens-tree-runner-nz-ochre 的价格是多少？有 10 码吗？”
• “这款空气炸锅卖 $79，价格划算吗？https://www.walmart.com/ip/844320666”
• “比较这三个商品页面，告诉我今天能买到的最便宜款：…”
• “显示这款商品过去两周的价格变化。”

CartScout 会读取商品页面，但不会搜索商店。请向 Agent 提供商品 URL，或先让它使用网页搜索工具查找商品。

配置

变量	默认值	用途
RAPIDAPI_KEY	必填	你的 RapidAPI 密钥
CARTSCOUT_RAPIDAPI_HOST	cartscout-api.p.rapidapi.com	API 的 RapidAPI 主机
CARTSCOUT_API_URL, CARTSCOUT_API_KEY	未设置	使用直接签发的 CartScout 密钥，而非 RapidAPI

服务只会向 CartScout API 发送 Agent 要查询的商品 URL。即使没有密钥，服务仍会启动并列出工具（便于使用 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