MCP · Bol.com
读取与写入 · 内置防护
Bol.com MCP 服务器，接入 Claude、ChatGPT 与 Cursor
借助 Marktspan 的 Bol.com MCP 服务器，Claude、ChatGPT、Cursor 或任何 MCP 客户端都能用自然语言读取您的 Bol.com 店铺并直接行动：查看贡献利润、找出浪费的广告花费，再修改价格、出价与预算。每次变更都先生成预览，大幅变动需要您明确确认。
Bol.com MCP 服务地址
https://marktspan.com/api/mcp
把 Bol.com 接入 Claude、ChatGPT 或 Cursor
三步，约五分钟。同一地址适用于所有 MCP 客户端。
- 创建 Marktspan 工作区并连接 Bol.com NL 或 BE 店铺（在应用中一次性完成）。
- Claude：设置 → Connectors → 添加自定义连接器 → 粘贴 https://marktspan.com/api/mcp。ChatGPT：开发者模式 → 创建 MCP 应用 → 同一地址。Cursor：在 mcp.json 中添加远程 MCP 服务器。
- 使用 Marktspan 登录，并选择助手只能读取，还是也可以修改。
读取：看懂您的 Bol.com 店铺
助手会自动选择工具，数字与 Marktspan 损益和 Ad Pilot 一致。
- 按天、EAN 或店铺的销售额、订单与贡献利润，已扣除佣金、LVB 费用与广告花费。
- 商品销售或利润变化的原因：Buy Box、库存、价格、广告或成本。
- Sponsored Products：花费、ACoS、TACoS、广告活动，以及花钱却无订单的搜索词。
- Bol.com 关键词需求：搜索量、趋势、中标出价与最佳细分类目。
- 财务：按订单与 EAN 的 Bol 发票明细（佣金、拣货打包、运费、退货）。
- 变更记录：每次出价与预算变更的新旧值。
写入：在同一对话中直接执行
以写入权限连接后，助手可以执行您刚讨论过的变更。
- 更新单个 EAN 或整份清单的 Bol 商品价格。
- 提高、降低、暂停或启用关键词出价。
- 修改广告活动预算、日期、NL 与 BE 投放和展示渠道，或开关广告活动。
- 添加新关键词，排除浪费预算的搜索词。
- 根据方案创建完整的新广告活动（以暂停状态创建，检查前不会花钱）。
- 通过表格更新成本价与商品数据，让贡献利润保持准确。
每次变更都有防护
修改在线店铺不能只靠一句“好的”。无论使用哪个 AI 客户端，每次写入都会执行以下检查。
- 先预览：每次写入都先 dry run，确认前不会推送到 Bol.com。
- 新旧对照：预览显示当前价格、出价或预算、新值以及变动百分比。
- 50% 规则：价格、出价或预算相对当前值变动超过 50% 时会被标记并拦截，直到您明确确认该变更。
- 出价限制：超过 €7.50 的出价需要额外确认；超过 €10 或远高于市场中标出价时给出警告；超出 Bol €0.20 至 €50 范围的出价会被拒绝。
- 权限范围：写入权限在登录时单独授予，仅运营角色可写入，商品访问组限制可修改的 EAN。NL 与 BE 绝不混用。
- 完整审计：每次调用都会记录，您可以随时询问助手何时改了什么。
Bol.com MCP 工具
服务器提供的部分工具。AI 会自动选择。
| 工具 | 类型 | 返回内容 | 示例提问 |
|---|---|---|---|
| query_metric | 读取 | 来自 Bol 损益的销售额、订单、贡献利润与库存覆盖，已扣除佣金、LVB 费用与广告花费。 | Bol NL 上周贡献利润下降了吗？ |
| query_metric · sales_pulse_diagnose | 读取 | 解释商品销售或利润变化的原因：丢失 Buy Box、断货、调价、广告缩减、低于成本。 | 本月哪些 EAN 营收损失最多？为什么？ |
| get_ad_decision_pack | 读取 | 调整出价前查看每个商品的 TACoS、贡献利润、底价、单位成本与库存。 | 我能给前 10 个商品提高出价吗？ |
| get_search_terms | 读取 | 搜索词的点击、花费、转化与 ACoS。 | 本月哪些搜索词花了钱却没有订单？ |
| search_keyword_demand | 读取 | Bol.com 搜索量、趋势与平均中标出价，无需连接店铺。 | 荷兰消费者围绕 “airfryer” 搜索什么？ |
| query_viz · bol_finance_report_lines | 读取 | 按订单与 EAN 的 Bol 发票明细：佣金、拣货打包、运费、退货与更正。 | 9 月 Bol 对这个 EAN 收了多少佣金？ |
| get_ad_activity | 读取 | 每次出价与预算变更的旧值、新值、时间与来源。 | 本周我的广告活动有哪些变化？ |
| update_offer_prices | 写入 | 修改 Bol 商品价格。预览显示当前价、新价与变动百分比。 | 把这五个 EAN 提价 5%，先给我看预览。 |
| update_keyword_bids | 写入 | 设置关键词出价或暂停、启用关键词，新旧出价并列显示。 | 降低 ACoS 高于 40% 的关键词出价。 |
| update_campaign | 写入 | 日预算或总预算、开关、起止日期、NL 与 BE 投放、展示渠道。 | 把我最好的广告活动预算提高到每天 €40。 |
| create_keywords · create_negative_keywords | 写入 | 向广告组添加精确或词组关键词，或排除浪费预算的搜索词。 | 排除那些花了钱却没有订单的搜索词。 |
| create_campaign | 写入 | 根据方案创建完整的 Sponsored Products 广告活动，默认以暂停状态创建。 | 为我的新空气炸锅 EAN 创建每天 €20 的广告活动。 |
| import_product_sheet | 写入 | 通过表格更新成本价、生命周期、类目、包装尺寸与分组，让损益保持准确。 | 这是新的成本价表，请更新成本。 |
示例工作流
一个对话从周复盘到调整
询问 Bol NL 上周贡献利润的变化，下钻到相关 EAN，再降低不再回本的出价。预览会显示每个出价调整前后的值。
砍掉浪费的广告花费
询问哪些搜索词花了预算却没有订单，排除它们，并暂停持续亏钱的关键词。
安全改价
找出低于底价的 EAN，准备新价格并查看预览。把价格误改成一半的输入错误会被 50% 规则拦下。
FAQ
- 什么是 Bol.com MCP 服务器？
- MCP（Model Context Protocol）服务器为 Claude、ChatGPT、Cursor 等 AI 助手提供读取与修改数据的工具。Bol.com MCP 服务器把它们连接到您的 Bol 卖家账户：订单、销售额、广告、关键词与价格。
- 如何把 Bol.com 接入 Claude？
- 在 Marktspan 连接 Bol 店铺，然后在 Claude 打开设置 → Connectors → 添加自定义连接器，粘贴 https://marktspan.com/api/mcp 并用 Marktspan 登录。
- 支持 ChatGPT 和 Cursor 吗？
- 支持。任何支持远程 MCP 的客户端都可使用同一地址：ChatGPT（开发者模式）、Cursor、Claude Code、VS Code 等。
- 助手能修改 Bol 上的价格、出价与预算吗？
- 可以，前提是您在登录时授予写入权限。每次变更都先显示当前值与新值的预览，经您确认后才生效。
- 如何防止错误变更上线？
- 每次写入都先 dry run。相对当前价格、出价或预算变动超过 50% 的变更会被拦截，直到您明确确认；高出价需要额外确认；每次调用都有记录。
- 需要把 Bol API 密钥贴进 AI 应用吗？
- 不需要。通过 OAuth 登录 Marktspan，Bol 连接保存在工作区，助手不会获得 Retailer API 凭据。
在团队已在用的助手里运营您的 Bol.com 店铺
我们可以在您的工作区演示连接器设置。