跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 idealo,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
通过 idealo 的 Partner Web Service,在 AI 智能体中维护你的店铺在 idealo 比价平台上的报价:按 SKU 读取报价,并在你批准后新建或替换报价、修改价格、配送时间和标题,或下架报价。适用于已在 idealo 上架的店铺。
试试这样问
idealo 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → idealo、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
idealo
通过 idealo 的 Partner Web Service,在 AI 智能体中维护你的店铺在 idealo 比价平台上的报价:按 SKU 读取报价,并在你批准后新建或替换报价、修改价格、配送时间和标题,或下架报价。适用于已在 idealo 上架的店铺。
设置
设置大约需要 3 分钟。你需要一家已在 idealo 上架的店铺 (与 idealo 签有商家合同),并能访问 idealo Business。
- 登录 idealo Business,打开 Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients)。
- 创建一个可访问 Partner Web Service 的 API 客户端,复制它的 client ID 和 client secret。secret 只显示一次;如果已经找不到,请新建一个客户端。
- 把 client ID (UUID 格式) 粘贴到
IDEALO_CLIENT_ID,secret 粘贴到IDEALO_CLIENT_SECRET,把 idealo Business 中显示的数字 shop ID 填入IDEALO_SHOP_ID。AnythingMCP 会用客户端凭证换取有效期一小时的访问令牌,并自动续期。 - 安装连接器,用一个你确定已上线的报价的 SKU 运行
idealo_get_offer:你会看到 idealo 所存储的报价内容。
可读取的内容:按 SKU 一次读取一条报价,内容与 idealo 存储的一致:标题、价格和原价、URL、EAN 和制造商编号、品牌、运费和支付费用、配送时间、能效标签、商品状况以及其他报价字段。Partner Web Service 没有列表接口,所以 AI 会向你询问 SKU。
只有报价,没有订单:Partner Web Service 2.0 是 idealo 提供给上架店铺逐条维护报价的接口,可以替代商品数据源,也可以与之并用,适用于 idealo.de、.at、.fr、.it、.es 和 .co.uk。idealo 已在 2023 年关闭了结账服务 (Direktkauf) 及其订单 API,所以订单仍然通过你自己的店铺进来。
报价的写法:价格是保留两位小数的字符串,例如 "177.99";原价是降价前的价格。新报价至少需要 SKU、标题、价格、URL、一项运费 (例如 "DHL": "4.90") 和一项支付费用 (例如 "PAYPAL": "0.00");EAN、制造商编号和品牌能帮助 idealo 匹配商品。idealo_upsert_offer 会替换整条报价,未发送的字段都会被删除;idealo_update_offer 只修改发送的字段,但不能修改运费和支付费用、尺码、颜色、性别、材质和动态商品属性,而且 EAN、图片等列表字段必须完整发送。SKU 只能包含字母、数字、下划线、点和连字符。
每次修改前都会询问:安装时没有开启任何写入工具。管理员开启后,AI 会向你展示报价的旧值和新值,或告诉你将要下架的 SKU,等你同意后才会上线。
安装时关闭:idealo_upsert_offer、idealo_update_offer 和 idealo_delete_offer。idealo 没有测试环境,每次写入都会立即改变比价平台上正在展示的报价,下架的报价会从 idealo 上消失。只开启允许 AI 使用的工具。一次性删除全部报价的功能是有意不提供的。
限制:idealo 限制调用次数,当前上限显示在 X-RateLimit-Limit 请求头中。遇到 429 时,AI 会等待后再重试,并且一次只修改一条报价。
常见错误:401 表示 client ID 或 secret 有误,或令牌被拒绝,请在 Shop settings → API clients 中检查。403 表示该 API 客户端没有 Partner Web Service 权限,或 shop ID 不属于你。404 表示此店铺中不存在该报价 (SKU 或 shop ID 有误)。400 会列出 fieldErrors,包含字段和原因,例如价格不是两位小数。
该连接器不会读取或处理订单,不会列出你的全部报价,不会修改你的商品数据源,也不会一次性删除全部报价。
前提条件: IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 idealo 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
idealo_get_offer | Read one of your offers on idealo by its SKU, as idealo stores it: title, price and former price, URL, EANs and manufacturer numbers… |
idealo_upsert_offer | Create an offer on idealo or replace it completely (PUT): every field not sent is removed from the offer |
idealo_update_offer | Change some fields of an existing idealo offer (PATCH), e.g. the price, former price, delivery time or title, and keep the rest |
idealo_delete_offer | Remove one offer from idealo by its SKU; it disappears from the price comparison |
示例提示
- “我 SKU 为 KS-4711 的报价现在在 idealo 上是什么样的?价格、配送时间和运费各是多少?”
- “把 SKU TV-55-OLED 的价格降到 899.00 欧元,并把 999.00 欧元显示为原价。”
- “把 SKU BOSCH-GSR18 的配送时间改为 1-3 个工作日。”
- “为 SKU LAMP-200 (EAN 4006381333931) 在 idealo 上新建报价:售价 49.90 欧元,DHL 运费 4.90 欧元,PayPal 不加收费用。”
- “把 SKU KS-4711 的报价从 idealo 下架,这件商品已经卖完了。”
下一步
这份指南对你有帮助吗?