bol.com MCP 服务器：订单、报价与发货

💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → bol.com，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

bol.com

bol.com 零售商 API 适用于荷兰和比利时市场的卖家：订单、带追踪的发货、退货、FBB 库存、带价格和库存的报价、佣金、目录内容、竞争报价、评级、发票和绩效指标。客户端 ID 和密钥。

设置

设置大约需要 3 分钟。你需要一个 bol.com 卖家账户（Verkopen via bol）和访问 bol 卖家仪表板中的 API 设置。连接器需要零售商 API 的客户端 ID 和客户端密钥。

1. 在 bol 卖家仪表板中打开你的账户，然后 Instellingen → Diensten → API Instellingen（设置、服务、API 设置）。如果 bol 要求，保存一个技术联系人。
2. 在 Client credentials voor de Retailer API 下点击 Aanmaken（创建），给密钥命名并点击 Toon secret（显示密钥）。
3. 将 client ID 复制到 BOL_CLIENT_ID，将 secret 复制到 BOL_CLIENT_SECRET。如果密钥丢失，请创建新的凭据。
4. 安装连接器。运行 bol_com_list_orders 检查连接：它返回你自己发货的未完成订单（FBR）。

云端和自托管的工作方式相同：凭据相同，没有重定向 URL 或 IP 地址需要注册。

身份验证：连接器在 https://login.bol.com/token（客户端凭据）处交换客户端 ID 和密钥以获取一个大约持续 5 分钟的承载令牌，并在过期之前重复使用。它不会在每次调用时请求新的令牌，因为 bol 会阻止频繁访问其登录服务的地址。

从哪里开始：bol_com_list_orders 列出未完成的 FBR 订单，最新的在前；bol_com_get_order 添加客户的运输和账单详细信息及商品。bol_com_list_offers 列出你的报价，bol_com_list_inventory 显示 bol 为你在其仓库中持有的库存（FBB）。

它读取的内容：订单、带运输和追踪的发货、带原因和客户评论的退货、FBB 库存、带价格、库存和国家可用性的报价、为什么某个报价不可售、某个价格下产品的佣金、按 EAN 的 bol 目录内容、竞争报价及谁拥有购买框、每个报价的星级评分、访问量和购买框百分比、每周的卖家绩效指标，以及发票（只读）。

发货：bol_com_create_shipment 确认你自己发货的商品的发货，包含你的承运人和追踪代码。bol_com_add_track_and_trace 将缺失的代码添加到发货中；它无法更改现有代码。

报价：bol_com_create_offer 和 bol_com_update_offer 创建报价并更改价格、库存、履行、国家或待处理标志。更新仅更改给定的字段，但数组（捆绑价格、国家）会整体替换旧的。409 表示有人同时更改了报价。价格以欧元计，包括增值税，库存为 0 到 999。

安装时关闭：bol_com_cancel_order_item（取消无法交付的订单项）和 bol_com_delete_offer（删除报价）。取消无法撤销，并会影响你的卖家评分，删除的报价会立即从 bol 中消失且无法恢复。要暂停报价，请使用 bol_com_update_offer 将其设置为待处理。仅在 AI 应该使用它们时在连接器页面上启用；AI 会要求你确认每个更改。发货、追踪和创建及更新报价已启用。

异步写入：发货、运输和取消的响应为处理状态而非结果。bol_com_get_process_status（或通过实体和事件类型的 bol_com_find_process_statuses）显示何时为 SUCCESS 或 FAILURE。bol 会保留处理状态一天。报价是同步的。

分页：订单、发货、退货和库存列表从 1 开始的 page，每页 50 行；空响应意味着没有更多页面。报价使用游标：传递 page.nextCursor 直到它缺失。

速率限制：bol 为每个端点设置速率限制。订单列表和发货列表允许每分钟 25 次调用，退货和库存每分钟 20 次，发票每分钟 24 次；订单详情每秒 25 次，报价每秒 25 到 50 次。429 会返回一个 Retry-After（重试后）时间（秒）；实时值在 api.bol.com/retailer/public/ratelimits。

ID 和格式：订单 ID 可以包含字母（A4K8290LP0），EAN 是字符串，日期格式为 YYYY-MM-DD，时间为带偏移的 ISO 8601。未使用的字段将被省略，因为 bol 对空字符串返回 400。

常见错误：错误以 application/problem+json 格式返回，包含 title、detail 和命名字段的 violations。400 通常意味着缺少或为空的字段。429 是速率限制：等待 Retry-After 时间。

未涵盖：处理或注册退货（接受退货会使 bol 退款给客户）、购买运输标签以及任何涉及资金流动的内容。

先决条件：BOL_CLIENT_ID，BOL_CLIENT_SECRET

本地安装连接器

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，选择 bol.com 并粘贴在先决条件下列出的环境变量。

可用工具

示例提示

• "今天还有哪些未发货的订单需要发货，是否有取消请求？"
• "显示订单 A4K8290LP0 的客户地址和商品。"
• "我的哪些报价不可售，原因是什么？"
• "谁拥有 EAN 8712345678901 的购买框，价格是多少？"
• "将我的 EAN 8712345678901 的报价价格设置为 24.95，库存设置为 40。"

下一步

• 连接到 Claude
• 连接到 ChatGPT