摘要
refurbed 卖家 API 适用于翻新电子产品的卖家:订单和订单项(接受、带跟踪和 IMEI 发货)、退款干运行、运输标签、发票、退货、支持票、带库存和价格的报价、市场价格、产品查找、运输配置文件和承运人。来自 refurbed 的 API 令牌。
引导式设置
2 分钟将 refurbed 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 refurbed,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
refurbed 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → refurbed,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
refurbed + Microsoft Copilot
refurbed 卖家 API 适用于翻新电子产品的卖家:订单和订单项(接受、带跟踪和 IMEI 发货)、退款干运行、运输标签、发票、退货、支持票、带库存和价格的报价、市场价格、产品查找、运输配置文件和承运人。来自 refurbed 的 API 令牌。
前提条件
请参阅连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
REFURBED_API_TOKEN
第 1 步 — 获取凭据
设置大约需要 5 分钟。你需要 refurbed 的答案。
- 使用 supplier.refurbed.com/api-token-request 的表单请求 API 令牌(或询问你的客户经理或 [email protected])。refurbed 会发送一个看起来像 UUID 的令牌。
- 将其粘贴到
REFURBED_API_TOKEN中,安装并运行refurbed_list_orders。连接器将其作为Authorization: Plain发送,后跟令牌。 - 未使用的令牌在 2 个月后会过期;然后请求一个新的。有些调用也必须由 refurbed 为你的账户启用(运输标签、新电池报价)。
API 运行在 https://api.refurbed.com。refurbed 还会根据请求为每个卖家提供一个沙盒(supplier.refurbed.com/sandbox-request),地址类似于 https://grpc-<name>.qa.refurbed.io,并包含测试订单;自托管安装可以将此连接器的副本指向该地址。
从哪里开始:refurbed_list_orders 状态为 NEW 显示待处理的订单;refurbed_get_order 和 refurbed_list_order_items 显示订单项。使用 refurbed_accept_order_item 接受,然后使用 refurbed_ship_order_item 发货(跟踪链接,或来自 refurbed_list_available_carriers 的承运人缩略名加上跟踪号码,以及 item_identifiers 中的 IMEI 或序列号)。refurbed_batch_update_order_item_states 一次最多处理 50 个;refurbed_update_order_item 后续更改跟踪、标识符、备注或瑞士海关数据;refurbed_get_order_item 读取一个订单项。
订单项状态:NEW 转为 ACCEPTED、REJECTED 或 CANCELLED;ACCEPTED 转为 SHIPPED 或 CANCELLED;SHIPPED 可以变为 RETURNED。跳过一步会失败,代码为 9(无法将状态从新状态更改为已发货)。REJECTED 和 CANCELLED 是最终状态,不会退款:refurbed_reject_order_item 安装时关闭,refurbed 期望你先通过票务告知客户。订单状态是根据其项计算的。请勿使用已弃用的字段 parcel_tracking_number、parcel_tracking_carrier 和单个 item_identifier。
退款:此连接器从不退款。refurbed_calculate_item_refund 和 refurbed_calculate_order_refund 是干运行,显示金额;退款本身在卖家界面中完成(需要一个开放的票务)。
标签、发票、退货、票务:refurbed_list_shipping_labels 提供新标签链接;refurbed_create_shipping_label(关闭)在 refurbed 的运输协议上创建真实标签。refurbed_get_order_invoice 链接你上传的发票。refurbed_list_returns 列出带有 refurbed 退货标签的退货;当包裹到达时,将项目设置为 RETURNED。refurbed_list_tickets 和 refurbed_get_ticket 读取客户票务。
报价:refurbed_list_offers、refurbed_get_offer、refurbed_create_offer(使用 refurbed_get_instance 查找产品,使用 refurbed_list_shipping_profiles 查找配置文件)、refurbed_update_offer 和 refurbed_batch_update_offers 用于库存和价格。通过 SKU 确定报价:报价 ID 在报价被重新创建时会更改。库存为 0 时暂停;refurbed_delete_offer 关闭。每个市场的固定价格:refurbed_list_market_offers、refurbed_create_market_offer、refurbed_update_market_offer、refurbed_delete_market_offer(关闭);仅 refurbed_list_markets 的站点市场接受它们。仅接受新报价的保修 M12;分级为 AA、A、B 或 C。
其他查找:refurbed_list_merchant_addresses(标签的发件人地址 ID)和 refurbed_get_currency(汇率;设置检查使用它)。
API 的工作原理:每个调用都是将 JSON 主体 POST 到 /refb.merchant.v1.<Service>/<Method>。字段名称为 snake_case;ID 是以字符串形式发送和返回的整数("3496079");货币是带小数点的字符串("199.99",拒绝逗号);时间为 UTC 的 RFC 3339;枚举按名称发送。通过 SKU 或 ID 提供报价,永远不要同时提供两者。列表页面带有游标:在 has_more 为 true 时,将最后一个 ID 作为 starting_after 传递,最多 100 行。批量处理 1 到 50 个项目,每个项目回答一个状态。
限制和错误:默认情况下每秒 10 个请求(头部 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset);超过限制会收到 429 RESOURCE_EXHAUSTED。错误响应 code 和 message 以及 gRPC 代码:3 无效参数,5 未找到,6 已存在,7 权限被拒绝,9 失败的前提条件,16 未经身份验证。
条款:refurbed 的 API 条款允许为卖家行动的集成商,但每个操作必须可追溯到卖家,API 数据不得转售或用于基准测试或市场情报。
写入:请先确认。 接受、发货、跟踪、库存和价格更改会影响实时账户。在每次调用之前,向用户显示更改内容并等待确认。
第 2 步 — 安装适配器
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
第 3 步 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
refurbed的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
refurbed_list_orders | 列出订单,默认按最新排序:id、released_at、state(NEW、ACCEPTED、SHIPPED、FULFILLED、CANCELLED 等)、标签(例如… |
refurbed_get_order | 读取一个订单及其所有项:状态、标签、客户电子邮件、运输和发票地址(带增值税号码)、总计和结算… |
refurbed_list_order_items | 列出一个订单的项:id、名称、状态、sku、总计、佣金、税收、报价数据(报价 ID、分级、保修、运输… |
refurbed_get_order_item | 通过其自身 ID(而不是订单 ID)读取一个订单项:状态、sku、价格和佣金、报价数据、跟踪链接和承运人… |
refurbed_accept_order_item | 接受一个 NEW 订单项(状态 ACCEPTED):你确认将发货。返回更新后的项 |
refurbed_ship_order_item | 将一个 ACCEPTED 订单项标记为 SHIPPED 及其跟踪:完整的 parcel_tracking_url,或 parcel_carrier_tracking_number(承运人缩略名和… |
refurbed_update_order_item | 在不更改状态的情况下更改订单项:替换跟踪链接或承运人跟踪号码,添加标识符(IMEI、序列号)… |
refurbed_batch_update_order_item_states | 一次在一个调用中更改最多 50 个订单项的状态(接受或发货多个)。每次更新都有单个调用的字段;响应… |
refurbed_reject_order_item | 拒绝(NEW 项)或取消(NEW 或 ACCEPTED 项)一个订单项。最终且无法撤销;它不会自动退款给客户… |
refurbed_calculate_item_refund | 干运行:显示退款一个订单项的含义(total_paid、total_refunded、refunded、refurbed 和商户份额)而不… |
refurbed_calculate_order_refund | 干运行:显示退款所有可退款订单项的金额,而不退款任何内容 |
refurbed_list_shipping_labels | 列出为订单创建的运输标签:id、打印机 PDF 链接(大约在一小时后过期,再次调用以获取新链接)、跟踪… |
refurbed_create_shipping_label | 在 refurbed 的运输协议上为订单创建运输标签(今天为 DHL Express)。每次调用都会创建一个新的真实标签及其… |
refurbed_get_order_invoice | 获取你为订单上传的发票的下载链接(有效期 24 小时)。当没有时返回 NOT_FOUND |
refurbed_list_returns | 列出运行在 refurbed 退货标签上的退货:id、order_id、order_item_id、instance_name、标识符、状态(INITIATED、IN_TRANSIT… |
refurbed_list_tickets | 列出客户支持票务:id、状态(OPEN、PENDING、SOLVED、CLOSED)、主题、紧急程度、客户、订单和订单项… |
refurbed_get_ticket | 读取一个支持票务及其消息、主题、状态、订单引用和备注 |
refurbed_list_offers | 列出你的报价:id、sku、instance_id 和 instance_name、状态(OK、UNVERIFIED、PENDING_REVIEW、REJECTED 及拒绝原因)、分级… |
refurbed_get_offer | 通过 SKU 或 ID 读取一个报价:状态、分级、保修、库存、运输配置文件、税收、参考价格和市场价格… |
refurbed_create_offer | 为产品创建报价:instance_id(refurbed_get_instance),或 gtin 或 mpn(报价在 refurbed 检查之前为 UNVERIFIED… |
refurbed_update_offer | 通过 SKU 或 ID 更改报价:库存、参考价格和最低价格、分级、保修、运输配置文件或税收;仅提供的字段… |
refurbed_batch_update_offers | 在一个调用中更改最多 50 个报价(库存和价格更新)。每个条目都有标识符以及 refurbed_update_offer 的字段;响应… |
refurbed_delete_offer | 通过 SKU 或 ID 删除一个报价。无法撤销;要暂停报价,请使用 refurbed_update_offer 将库存设置为 0。安装时关闭 |
refurbed_list_market_offers | 列出一个报价的每个市场价格:market_code、是否为站点市场、设置或计算价格和最低价格、货币… |
refurbed_create_market_offer | 在一个站点市场中为报价设置固定价格,而不是从参考价格计算的价格。当市场… 时返回 ALREADY_EXISTS |
refurbed_update_market_offer | 更改一个市场中报价的固定价格。通过 sku 或 offer_id 和 market_code 提供报价 |
refurbed_delete_market_offer | 移除一个市场中报价的固定价格;价格将回落到从参考价格计算的价格。安装时关闭 |
refurbed_get_instance | 通过 GTIN、MPN 或 ID 查找 refurbed 产品(实例):ID 和名称。在创建报价时使用 ID 作为 instance_id。没有产品… |
refurbed_list_shipping_profiles | 列出你的运输配置文件:id、名称、源国、目的地市场及其费用和交货时间,以及每个配置文件使用的报价数量… |
refurbed_list_available_carriers | 列出 refurbed 可以跟踪的承运人:名称和缩略名。在使用跟踪号码发货时,使用缩略名作为承运人,而不是链接。缓存… |
refurbed_list_markets | 列出 refurbed 市场:代码(例如 de、at、fr)、名称、类型、currency_code 和 is_site(具有自己 refurbed 网站的市场,固定… |
refurbed_list_merchant_addresses | 列出你的地址:id、类型(DELIVERY 或 RETURN)、公司、街道、城镇、邮政编码和国家。ID 是发件人的地址… |
refurbed_get_currency | 读取货币及其汇率。无需卖家数据;用于检查令牌是否有效 |
示例提示
- "哪些 refurbed 订单项在等待接受?"
- "使用 DHL 跟踪 00340434161234567890 和 IMEI 356789012345678 发货订单项 9123456。"
- "我在市场上对 iPhone 14 128 GB 的报价是多少?"
- "本周有哪些退货到达?"
- "订单项 9123456 的退款金额是多少?"
常见问题
API 令牌来自哪里? 使用 refurbed 的 API 令牌表单请求,或从你的客户经理或 [email protected] 获取。未使用的令牌在两个月后过期。
它涵盖了什么? 订单和订单项(接受、带跟踪和 IMEI 发货)、退款干运行、运输标签、发票、退货、支持票、带库存和价格的报价、每个市场的价格、产品查找、运输配置文件和承运人。
哪些工具安装时关闭? refurbed_reject_order_item、refurbed_create_shipping_label、refurbed_delete_offer 和 refurbed_delete_market_offer。仅在 AI 应该使用时在连接器页面上启用它们。
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?