摘要
Back Market 卖家 API 供翻新商使用:带有跟踪的接受和发货订单,带有价格和库存的列表,Backbox 和竞争对手价格,类别,客户服务文件和消息,BackShip 交付和 BuyBack 订单。每个平台的 API 令牌(欧洲、美国、亚太地区)。
引导式设置
2 分钟将 Back Market 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Back Market,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Back Market 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Back Market,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Back Market + Meta Muse
Back Market 卖家 API 供翻新商使用:带有跟踪的接受和发货订单,带有价格和库存的列表,Backbox 和竞争对手价格,类别,客户服务文件和消息,BackShip 交付和 BuyBack 订单。每个平台的 API 令牌(欧洲、美国、亚太地区)。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET
第一步 — 获取凭据
设置大约需要 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 和 BuyBack: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 错误。
第二步 — 安装适配器
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
第三步 — 在 Muse 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
- 在聊天中,向 Muse 提出需要用到
Back Market的工具的请求。
你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
back_market_list_orders | 列出订单,不包括未付款的订单(默认情况下省略订单状态 0 和 8)。响应包含 count、next、previous 和 results[]… |
back_market_get_order | 读取一个订单:order_id、状态、创建日期、修改日期、付款日期、发货日期、预期发货日期、价格等… |
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、标题、product_id、等级(PREMIUM、EXCELLENT、VERY_GOOD、GOOD… |
back_market_get_listing | 通过你的 SKU 或 Back Market id 读取一个列表:id、listing_id、sku、标题、product_id、等级、数量、价格、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、产品、价格、数量、buybox(当你的列表持有 Backbox 时为 true)、price_for_buybox(… |
back_market_get_competitors | 读取一个列表的 Backbox 竞争情况,每个市场一行:is_winning、价格、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、订单行、状态(0 开放,9 关闭)、创建日期… |
back_market_get_care_folder | 读取一个客户服务文件:状态、日期、客户(名字、姓氏、电子邮件)、订单行及其订单和地址、… |
back_market_send_care_message | 在客户服务文件中向客户发送消息(仅文本,无附件)。客户在 Back Market 的售后平台上看到… |
back_market_create_care_refund | 从客户服务退款一条订单行:已付款行的全额退款(类型 4)、已接受行的全额退款(类型 5),或部分或… |
back_market_list_deliveries | 列出 BackShip 交付(仅适用于订阅了 Back Market 的 BackShip 运输服务的卖家):订单、shipmentId、订单行… |
back_market_list_returns | 列出 BackShip 产品退货(仅适用于订阅了 BackShip 的卖家):orderId、orderlineId、shipmentId、carrierName、trackingNumber… |
back_market_list_buyback_orders | 列出 BuyBack(以旧换新)订单,客户卖给你的设备:orderPublicId、状态、市场、creationDate、shippingDate、receivalDate… |
back_market_get_buyback_order | 读取一个 BuyBack(以旧换新)订单:状态、市场、日期(创建、发货、接收、付款、反提案)、列表、… |
示例提示
- "哪些 Back Market 订单的行等待我的接受?"
- "我的哪些列表失去了 Backbox,什么价格可以赢回它?"
- "将我翻新过的 iPhone 13 128 GB 列表的库存设置为 12。"
- "使用 Colissimo 跟踪 6A12345678901 和每条行的 IMEI 发货订单 41234567。"
- "哪些客户服务文件是开放的,客户在问什么?"
常见问题
我在哪里可以获得 API 令牌? 在你的平台的 Back Market 后台,选项,集成。按照示例粘贴令牌,不要加上 Basic,并选择你的平台(欧洲、美国或亚太地区)和主要市场。API 访问需要一个已被 Back Market 验证的卖家账户。
它覆盖哪些市场? 你的账户所在平台的每个市场:在 backmarket.fr 上的欧洲市场,在 backmarket.com 上的美国市场,以及在 backmarket.co.jp 上的日本和澳大利亚市场。带有市场参数的工具可以查看同一平台的另一个市场。
哪些工具默认关闭? back_market_cancel_order_line、back_market_refund_order_line、back_market_create_care_refund 和 back_market_import_listings,因为它们会退款给客户或批量替换列表。仅在 AI 应该使用它们时才在连接器页面上打开它们。
Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?