idealo MCP Server

idealo MCP 服务指南

idealo MCP 服务可将 idealo 的商品情报直接带入 AI 助手中 — 搜索商品、比较数百家商店的价格，并分析 6 个欧洲市场（DE、AT、GB、FR、IT、ES）的 30 天价格历史，无需离开编辑器。

说明

所有 idealo MCP 服务工具均受速率限制。

默认的 Trial 层级可通过 OAuth 自助使用，为每位用户提供 3 req/s · 6 burst · 500 calls/day。Trial 响应包含单张商品图片，get_product_offers 每件商品最多返回 10 个报价，且不包含商店徽标、外部链接和详细用户评论。

Partner 层级可解锁更高的速率限制、完整图片数组、商店徽标、测试报告链接和完整的用户评论数据。如需申请 Partner 访问权限，请通过 [email protected] 联系我们。

完整的工具参考（输入架构、示例响应、各层级的字段差异）请参阅 docs/tools.md。

功能

• 商品目录搜索 — 全文搜索，可按类别、品牌、价格范围、库存情况和优惠筛选，覆盖 6 个欧洲市场。返回加密的 productRef，可传递给其他工具。

• 商品详情 — 一次调用即可获取完整的商品资料：热门报价、评论摘要、专家评测、测试报告、技术规格、优缺点，以及 30 天价格趋势。

• 分页报价 — 查看商品的所有报价，包括商店名称、评分、价格明细、配送预估、付款方式、免费退货政策和运费。每页 5 个报价。

• 价格历史与分析 — 提供 30 天价格趋势、最低/最高/平均统计数据、百分比变化、采样粒度、ASCII 图表和 AI 生成的购买建议。

安装与设置

不同的 MCP 客户端所需的设置略有不同。请按照适用于你所用客户端的说明操作。

Claude Desktop

推荐通过自定义连接器进行设置：

1. 打开 Claude → Settings → Connectors。
2. 点击 Add custom connector。
3. 输入 URL https://mcp.idealo.com/mcp，然后点击 Add。
4. 根据提示进行身份验证 — Claude 会打开浏览器完成 OAuth 握手。

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

Claude Code

在终端中运行以下命令：

claude mcp add --transport http idealo https://mcp.idealo.com/mcp --callback-port 6274

{
  "mcpServers": {
    "idealo": {
      "type": "url",
      "url": "https://mcp.idealo.com/mcp",
      "oauth": {
        "callbackPort": 6274
      }
    }
  }
}

VS Code

1. 使用快捷键 ⌘ Shift P 搜索 MCP: Add Server。
2. 选择 HTTP。
3. 粘贴 https://mcp.idealo.com/mcp，然后按 Enter。
4. 根据提示输入服务 ID：idealo。
5. 选择全局或工作区范围。

生成的 mcp.json 如下所示：

{
  "servers": {
    "idealo": {
      "type": "http",
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

打开聊天工具栏，切换到 Agent 模式，然后输入 #search_products，确认工具可用。如果没有显示任何内容，请重启 VS Code。

说明

你必须启用 GitHub Copilot 才能在 VS Code 中使用 MCP。

Cursor

{
  "mcpServers": {
    "idealo": {
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

其他编辑器

任何支持 Streamable HTTP 传输方式的客户端都可以连接。请使用：

{
  "mcpServers": {
    "idealo": {
      "url": "https://mcp.idealo.com/mcp"
    }
  }
}

身份验证

该服务使用 OAuth 2.0，并结合 动态客户端注册（DCR）+ PKCE。符合规范的 MCP 客户端会通过 .well-known/oauth-protected-resource 自动发现身份验证流程——Trial 层级无需设置 client_id / client_secret。首次连接时，客户端会打开浏览器供你登录。令牌会缓存在客户端，并自动刷新。

Partner 层级的凭据由 idealo 根据申请单独发放。

提示 MCP 客户端

连接后，使用自然语言提示客户端。4 个工具通过 search_products 返回的不透明 productRef 串联起来。

示例：

• “查找在德国有售、价格低于 100 欧元的跑鞋。”
• “显示最便宜结果的详情、热门优惠和优缺点。”
• “逐一查看所有优惠，直到找到一项支持 PayPal 支付且免运费的优惠。”
• “提供 30 天价格历史，并告诉我现在是否适合买入。”

提示与最佳实践

• 使用 productRef。 search_products 会为每个结果返回一个加密的 productRef——将该字符串直接传给 get_product_details、get_product_offers 和 get_product_price_history。它是不透明的、会根据市场区分，且有效期较短。
• includeSearchFilters 和 includeSizeFilters 需要 includeCategories。 如果未至少提供一个数字类别 ID，服务会拒绝包含属性筛选条件或尺寸筛选条件的调用。先不带筛选条件进行搜索，以便从响应中发现可用的 categoryId。
• 选择正确的国家/地区。 将 country 设为 2 个字母的 ISO 代码（DE、AT、GB、FR、IT、ES）。未知代码会静默回退到德国。
• 正确分页获取优惠。 get_product_offers 每次调用会返回 5 个优惠以及一个 nextOffset。循环调用，直到 nextOffset === 0。
• 部分商店会被过滤。 合规屏蔽列表会从所有层级中移除 Amazon、eBay 和 Otto 的优惠——这是有意为之，且适用于所有层级。
• 始终使用同一个市场。 在 country=DE 下获取的 productRef，与 country=GB 一起使用时不会返回有用数据。

支持的市场

🇩🇪 德国 · 🇬🇧 英国 · 🇫🇷 法国 · 🇮🇹 意大利 · 🇪🇸 西班牙 · 🇦🇹 奥地利

支持

• 网站：idealo.de
• 工具参考：docs/tools.md
• Partner 层级申请：[email protected]
• 申请支持新的 MCP 客户端：[email protected]