摘要
Back Market 卖家 API 供翻新商使用：带有跟踪的接受和发货订单，带有价格和库存的列表，Backbox 和竞争对手价格，类别，客户服务文件夹和消息，BackShip 交付和回购订单。每个平台的 API 令牌（欧洲、美国、亚太地区）。
引导式设置
2 分钟将 Back Market 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Back Market，再把你的 MCP URL 添加到你的 AI 助手。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Back Market 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Back Market，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
Back Market
Back Market 卖家 API 供翻新商使用：带有跟踪的接受和发货订单，带有价格和库存的列表，Backbox 和竞争对手价格，类别，客户服务文件夹和消息，BackShip 交付和回购订单。每个平台的 API 令牌（欧洲、美国、亚太地区）。
设置
设置大约需要 3 分钟。
- 登录到你的平台的 Back Market 后台：
https://www.backmarket.fr/bo-seller（欧洲），https://www.backmarket.com/bo-seller（美国）或https://www.backmarket.co.jp/bo-seller（日本和澳大利亚）。API 访问需要一个已被 Back Market 验证的卖家账户。 - 在选项下打开 Integrations 页面并创建一个 API 令牌。
- 按照所示将令牌粘贴到
BACK_MARKET_TOKEN中，前面不要加上 Basic 这个词：连接器会将其作为Authorization: Basic后跟令牌发送。 - 在
BACK_MARKET_HOST中选择你的平台，在BACK_MARKET_MARKET中选择你的主要市场（例如，欧洲为 fr-fr，美国为 en-us，亚太地区为 ja-jp）。市场必须属于该平台。
每个调用都在 Accept-Language 中携带市场信息，并使用 User-Agent BM-AnythingMCP-Connector，这是 Back Market 所要求的。带有 market 参数的工具可以查看同一平台的另一个市场进行一次调用。
从哪里开始：back_market_list_orders 状态为 1 的调用显示待接受的已付款订单，状态为 3 的调用显示待发货的订单。back_market_list_listings 显示你的报价；back_market_list_backbox 告诉你哪些报价持有 Backbox。
订单工作流程：订单在支付验证后以状态 1 到达（永远不要发货状态 0、8 或 10）。使用 back_market_accept_order_line 接受每一行（行状态从 1 到 2）；然后订单移动到状态 3。使用 back_market_ship_order 和一个跟踪号码发货（所有行都放在一个包裹中，订单状态为 9）。back_market_get_order 显示行状态。back_market_set_order_line_identifiers 存储设备的 IMEI 或序列号；之后无法更正。back_market_cancel_order_line 和 back_market_refund_order_line 默认关闭：两者都会退款给客户且无法撤销，取消会影响 Backbox。
列表：一个列表覆盖平台的所有市场。数量是共享的；价格、评论和保修是按市场划分的。back_market_get_listing 通过 SKU 查找列表；back_market_update_listing 实时更改价格或库存（数量为 0 会下线）。back_market_import_listings（默认关闭）一次发送多个列表的 CSV，并返回 back_market_get_task 的任务 ID。back_market_get_competitors 显示每个市场赢得 Backbox 所需的价格。back_market_get_category_tree 和 back_market_get_category_branch 提供类别和新产品所需的属性。
客户服务：back_market_list_care_folders 和 back_market_get_care_folder 读取售后案例及其消息；back_market_send_care_message 回复客户。back_market_create_care_refund 默认关闭。
BackShip 和回购：back_market_list_deliveries 和 back_market_list_returns 仅返回使用 Back Market 的 BackShip 标签的卖家的数据。back_market_list_buyback_orders 和 back_market_get_buyback_order 读取以旧换新订单；验证或反对一个决定客户的付款金额，且不包括在内。
格式：价格是带税的十进制字符串，使用市场的货币（160.99）。订单 ID 和订单行 ID 是整数；列表 ID 是 UUID（数字 listing_id 已被弃用）。日期为 RFC 3339；客户服务文件夹过滤器使用 YYYY-MM-DD-hh-mm。列表返回 count、next、previous 和 results；next 在最后一页为 null。
限制：每 10 秒超过 200 次调用会被阻止 10 秒（目录调用：每 10 秒 20 次），返回 429。列表更新限制为每小时约 2,000 SKU 行。客户服务调用有每日限制（文件夹列表每天 4,000 次，退款每天 500 次）。
403 响应：Back Market 位于 Cloudflare 后面。带有 HTML 页面或代码 bot-need-challenge 的 403 表示防火墙阻止了调用者，而不是令牌错误：将响应的 cf-ray 值发送给你的 Back Market 联系人。错误或缺失的令牌也会返回 403 或 401，带有 JSON 错误。
先决条件：BACK_MARKET_HOST、BACK_MARKET_TOKEN、BACK_MARKET_MARKET
本地安装连接器
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，选择 Back Market 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
back_market_list_orders | 列出订单，不包括未付款的订单（默认排除订单状态 0 和 8）。响应包含 count、next、previous 和 results[]… |
back_market_get_order | 读取一个订单：order_id、state、date_creation、date_modification、date_payment、date_shipping、expected_dispatch_date、price 和… |
back_market_accept_order_line | 接受一条已付款的订单行（状态 1 到状态 2），确认你有该商品并将其发货。接受订单的每一行，逐一… |
back_market_ship_order | 将已接受的订单标记为已发货及其跟踪号码（状态 3）。订单的所有行都放入一个包裹中并设置为已发货… |
back_market_cancel_order_line | 取消一条无法交付的已付款订单行（状态 1 到状态 4）。Back Market 会为该行退款给客户，取消无法… |
back_market_refund_order_line | 通过订单工作流程退款一条订单行：状态 5 为已接受但尚未发货的行，状态 6 为已发货的行。客户… |
back_market_set_order_line_identifiers | 注册在一条订单行上销售的设备的 IMEI 和/或序列号。至少提供其中一个。小心：一旦注册，… |
back_market_list_listings | 列出你的列表（报价）：id（UUID）、listing_id（旧的数字 id）、sku、title、product_id、grade（PREMIUM、EXCELLENT、VERY_GOOD、GOOD… |
back_market_get_listing | 通过你的 SKU 或其 Back Market id 读取一个列表：id、listing_id、sku、title、product_id、grade、quantity、price、min_price… |
back_market_update_listing | 实时更改一个列表：价格、库存数量、评论、保修或 BackPricer 的最低价格。仅提供给定的字段… |
back_market_import_listings | 从 CSV 文本创建或更新多个列表（并提出新产品），最多 15,000 行。每行需要你的 sku；新列表也… |
back_market_get_task | 读取由 back_market_import_listings 启动的批处理任务的结果：task_id、action_status（0 或 2 = 等待或运行，8 = 失败，9… |
back_market_list_backbox | 按列表列出 Backbox 数据：sku、product、price、quantity、buybox（当你的列表持有 Backbox 时为 true）、price_for_buybox（… |
back_market_get_competitors | 读取一个列表的 Backbox 竞争情况，每个市场一行：is_winning、price、min_price、price_to_win 和 winner_price（每个都有… |
back_market_get_category_tree | 读取整个类别树：category_id、category_name、marketplace_category_id（产品类别必须匹配的值）、is_leaf 和… |
back_market_get_category_branch | 读取一个类别，字段与树相同：category_id、category_name、marketplace_category_id、is_leaf 和 attributes[] 包含… |
back_market_list_care_folders | 列出客户服务文件夹（售后案例，SAV），每页 10 个：id、orderline、state（0 开放，9 关闭）、date_creation… |
back_market_get_care_folder | 读取一个客户服务文件夹：state、dates、客户（名、姓、电子邮件）、订单行及其订单和地址、… |
back_market_send_care_message | 在客户服务文件夹中向客户发送消息（仅文本，无附件）。客户在 Back Market 的售后平台上看到… |
back_market_create_care_refund | 从客户服务退款一条订单行：已付款行的全额退款（类型 4）、已接受行的全额退款（类型 5），或部分或… |
back_market_list_deliveries | 列出 BackShip 交付（仅适用于订阅了 Back Market 的 BackShip 运输服务的卖家）：order、shipmentId、orderlines… |
back_market_list_returns | 列出 BackShip 产品退货（仅适用于订阅了 BackShip 的卖家）：orderId、orderlineId、shipmentId、carrierName、trackingNumber… |
back_market_list_buyback_orders | 列出回购（以旧换新）订单，客户卖给你的设备：orderPublicId、status、market、creationDate、shippingDate、receivalDate… |
back_market_get_buyback_order | 读取一个回购（以旧换新）订单：status、market、dates（创建、发货、接收、付款、反提案）、列表、… |
示例提示
- "哪些 Back Market 订单的行等待我的接受？"
- "我的哪些列表失去了 Backbox，什么价格可以赢回它？"
- "将我翻新过的 iPhone 13 128 GB 列表的库存设置为 12。"
- "使用 Colissimo 跟踪 6A12345678901 和每行的 IMEI 发货订单 41234567。"
- "哪些客户服务文件夹是开放的，客户在问什么？"
下一步
这份指南对你有帮助吗?