摘要
面向音乐设备卖家的 Reverb API:拥有草稿的列表、更新和发布、订单和带追踪的运输、买家消息、报价、退款请求、付款和商店数据。个人访问令牌。
引导式设置
2 分钟将 Reverb 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Reverb,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Reverb 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Reverb,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Reverb
面向音乐设备卖家的 Reverb API:拥有草稿的列表、更新和发布、订单和带追踪的运输、买家消息、报价、退款请求、付款和商店数据。个人访问令牌。
设置
设置大约需要 3 分钟。
- 登录到 reverb.com,打开你的用户菜单,进入 我的个人资料。
- 点击 API & Integrations 标签,然后 生成新令牌。
- 输入名称并勾选范围:
public、read_listings、write_listings、read_orders、write_orders、read_messages、write_messages、read_offers、write_offers、read_payouts和read_profile。缺少范围的工具将被拒绝。 - 将令牌复制到
REVERB_TOKEN。个人访问令牌不会过期。
Reverb 要求每位卖家在使用 API 之前设置账单并至少在 reverb.com 上手动创建一个列表。
从哪里开始:reverb_list_orders_awaiting_shipment 显示需要发货的订单。reverb_list_my_listings 显示你的实时列表(状态包括所有草稿和已结束的);reverb_get_shop 显示商店及其运输配置文件。
列表:使用 reverb_create_listing 创建草稿(类别 uuid 来自 reverb_list_categories,条件 uuid 来自 reverb_list_listing_conditions,运输配置文件 id 来自 reverb_get_shop),使用 reverb_update_listing 修改它,并使用 reverb_publish_listing 上架。reverb_list_my_drafts 列出未发布的草稿,reverb_get_listing 读取一个列表。通过你的 SKU 使用 reverb_list_my_listings 和 sku 查找列表。只有全新、B-Stock 和 Mint 条件的库存可以持有多个单位;二手商品为单件,售出后不能重新上架。将库存设置为 0 将结束该列表。reverb_end_listing 安装时处于关闭状态。
订单:reverb_list_orders(所有,按最后更改过滤),reverb_list_orders_awaiting_shipment,reverb_get_order。仅在状态为已付款时发货,使用 reverb_ship_order(提供者来自 reverb_list_shipping_providers 和追踪号码);本地自取使用 reverb_mark_order_picked_up 关闭。运输标签不能通过此连接器购买。
消息和报价:reverb_list_conversations、reverb_get_conversation 和 reverb_send_message 处理买家消息。reverb_list_offers 和 reverb_get_offer 读取你列表上的报价;reverb_decline_offer 拒绝一个报价。reverb_accept_offer 和 reverb_counter_offer 安装时处于关闭状态,因为两者都使你承诺一个价格。
退款和付款:reverb_list_refund_requests 读取退款请求。reverb_respond_to_refund_request 和 reverb_create_refund_request 安装时处于关闭状态:批准退款会立即给买家记账并从你那里扣款。reverb_list_payouts 和 reverb_list_payout_line_items 读取 Reverb 支付到你银行的金额及每个订单的费用。
格式:货币是一个对象,包含 amount(十进制字符串,如 95.00)、amount_cents、currency 和 display;发送金额和货币。日期为带偏移的 ISO 8601。ID:订单使用订单号,列表使用数字列表 ID,类别和条件使用 uuid。
分页和链接:Reverb 以 HAL JSON 格式响应。列表携带 _links.next 和 _links.prev;当下一个缺失时,你在最后一页。使用 page 和 per_page 进行移动。每个对象还在 _links 下列出可用的操作。
错误:401 表示令牌错误或缺少范围;404 未找到;406 表示该操作会违反当前状态的规则;412 表示验证错误,包含 message 和每个字段的 errors;429 表示调用次数过多。
速率限制:读取每分钟 2,000 次或每 10 分钟 10,000 次;写入每分钟 600 次或每 10 分钟 3,000 次。避免一次同步整个商店。
沙盒:sandbox.reverb.com 是一个独立的网站,拥有自己的账户和令牌;此连接器调用生产 API。
先决条件:REVERB_TOKEN
本地安装连接器
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,选择 Reverb 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
reverb_list_my_listings | 列出你自己的列表及其 id、标题、品牌、型号、sku、条件、价格(金额和货币)、库存和 _links(该列表… |
reverb_list_my_drafts | 列出你的草稿列表(已创建但尚未发布),字段与 reverb_list_my_listings 相同:id、标题、品牌、型号、sku… |
reverb_get_listing | 通过 id 读取一个列表,字段包括创建列表所需的字段:标题、品牌、型号、表面、年份、描述、条件、类别… |
reverb_create_listing | 在你的 Reverb 商店中创建一个草稿列表。直到调用 reverb_publish_listing 之前,买家无法看到。至少提供一个标题… |
reverb_update_listing | 更新你的一个列表(草稿或实时):仅更改给定的字段。典型用途:价格、库存、描述、照片、运输… |
reverb_publish_listing | 发布一个草稿列表,以便买家可以查看和购买。草稿必须完整(品牌和型号已知、类别、条件、价格、照片… |
reverb_end_listing | 结束一个实时列表,使其无法再被购买。原因 not_sold 只是将其下架。原因 reverb_sale 表示你在… |
reverb_list_orders | 列出你销售的订单,所有状态:订单号、状态(未付款、付款待处理、待审核、被阻止、已付款、已发货、已自取… |
reverb_list_orders_awaiting_shipment | 列出已付款但仍需发货的订单,字段与 reverb_list_orders 相同(订单号、标题、数量、买家姓名… |
reverb_get_order | 通过订单号读取一个已售出的订单:订单号、状态(未付款、付款待处理、待审核、被阻止、已付款、已发货、已自取… |
reverb_ship_order | 将已付款的订单标记为已发货,提供承运人和追踪号码。使用 send_notification 为 true 时,Reverb 会立即向买家发送邮件… |
reverb_mark_order_picked_up | 将本地自取订单标记为已被买家自取(运输方式为本地)。订单状态变为已自取。仅在… |
reverb_list_shipping_providers | 列出 Reverb 接受的运输提供商(承运人),当订单标记为已发货时使用。使用提供商名称,必须与… |
reverb_list_conversations | 列出你在 Reverb 上的消息对话,每个对话都有其 id(需要读取或回复)和 _links。如果 unread_only 为 true,则仅… |
reverb_get_conversation | 详细读取一个对话,按时间顺序排列其消息(最旧的在前),以便可以查看与买家的整个交流… |
reverb_send_message | 在现有对话中回复。对方会立即在 Reverb 上收到消息,且无法撤回,因此请谨慎书写… |
reverb_list_offers | 列出买家在你的列表上提出的活跃报价(Reverb 称之为谈判),每个报价都有其 id 以供 reverb_get_offer 和回答… |
reverb_get_offer | 通过 id 读取一个报价(谈判)的详细信息:它所在的列表、迄今为止提供的价格及其当前状态,包含指向… |
reverb_decline_offer | 拒绝买家在你列表上的报价。谈判在没有销售的情况下结束,拒绝无法撤回;没有价格… |
reverb_accept_offer | 接受买家的报价。这是有约束力的:你同意以报价价格和运输价格出售商品,买家可以立即付款… |
reverb_counter_offer | 用反报价回应买家的报价:你的价格和可选的运输价格。如果买家接受,反报价是有约束力的… |
reverb_list_refund_requests | 列出你销售的退款请求,默认是活跃的(pending_seller_response 和 conditionally_approved):id、状态、金额… |
reverb_respond_to_refund_request | 回应退款请求:conditionally_approved(一旦物品返回你将退款;请求保持开放),approved(立即退款… |
reverb_create_refund_request | 作为卖家对你已售出的订单发起退款,完全或部分退款。创建时状态为条件批准;资金在… |
reverb_list_payouts | 列出 Reverb 发送到你银行账户的付款:每次付款的总额(金额和货币)、创建时间、更新时间和 _links.line_items… |
reverb_list_payout_line_items | 列出一个付款的行项,每个订单一行:订单 ID、销售日期、销售价格、付款货币和扣除的费用(销售费用… |
reverb_get_shop | 读取你的商店:id、名称、描述和 shipping_profiles[](id 和名称),其 id 用于列表的 shipping_profile_id。运输… |
reverb_list_categories | 列出所有 Reverb 类别,作为一个平面列表,包含其 uuid 和名称。uuid 是列表类别所需的。列表较长;一些… |
reverb_list_listing_conditions | 列出你的商店可以在列表上使用的条件(非功能、差、一般、好、非常好、优秀、全新、B-Stock、全新):uuid… |
示例提示
- "哪些 Reverb 订单正在等待发货?"
- "为我的 2019 年 Gibson Les Paul Standard 创建一个优秀状态的草稿列表,价格为 2,200 美元。"
- "我列表上有哪些买家的开放报价?"
- "用 UPS 追踪 1Z999AA10123456784 发货订单 12345678。"
- "显示我上个月的付款及其行项。"
下一步
这份指南对你有帮助吗?