摘要
Reverb API 适用于音乐设备的卖家:拥有草稿的自有列表,更新和发布,带跟踪的订单和运输,买家消息,报价,退款请求,付款和商店数据。个人访问令牌。
引导式设置
2 分钟将 Reverb 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Reverb,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
Reverb 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Reverb,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Reverb + Claude
Reverb API 适用于音乐设备的卖家:拥有草稿的自有列表,更新和发布,带跟踪的订单和运输,买家消息,报价,退款请求,付款和商店数据。个人访问令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
REVERB_TOKEN
第一步 — 获取凭据
设置大约需要 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;当缺少 next 时,你在最后一页。使用 page 和 per_page 进行移动。每个对象还在 _links 下列出可用的操作。
错误:401 表示令牌错误或缺少范围;404 未找到;406 表示操作会违反当前状态的规则;412 表示验证错误,包含 message 和每个字段的 errors;429 表示调用次数过多。
速率限制:读取每分钟 2,000 次或每 10 分钟 10,000 次;写入每分钟 600 次或每 10 分钟 3,000 次。避免一次同步整个商店。
沙盒:sandbox.reverb.com 是一个具有自己账户和令牌的独立网站;此连接器调用生产 API。
第二步 — 安装适配器
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
第三步 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP 服务器 → 此连接器所在的服务器,复制其 URL (
https://cloud.anythingmcp.com/mcp/…)。在本指南中显示YOUR_SERVER_ID的地方使用它。
推荐路径:在 claude.ai web 上工作,无需编辑任何配置文件。
- 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
- 点击 + Add,然后 Add custom connector。
- 输入名称,例如
Reverb,以及远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。 - 选择 Sign in now,点击 Add,并登录到 AnythingMCP(OAuth)以允许访问。
以下所有工具将在你的聊天中出现:开始输入提示。
可用工具
| 工具 | 功能 |
|---|---|
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 | 列出你销售的订单,所有状态:order_number、状态(未付款、付款待处理、待审核、被阻止、已付款、已发货、已取件… |
reverb_list_orders_awaiting_shipment | 列出仍需发货的已付款订单,字段与 reverb_list_orders 相同(order_number、标题、数量、买家姓名… |
reverb_get_order | 通过订单号读取一个已售出的订单:order_number、状态(未付款、付款待处理、待审核、被阻止、已付款、已发货、已取件… |
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 读取一个报价(谈判)的详细信息:它所处的列表、迄今为止提供的价格及其当前状态,以及 _links… |
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 | 列出一笔付款的明细,每笔订单一项:order_id、销售日期、销售价格、付款货币和收取的费用(selling_fee… |
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。"
- "显示我上个月的付款及其明细。"
常见问题
它是否适用于 Claude Code 和 Claude Desktop? 是的,两个都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
我在哪里获取令牌? 在 reverb.com:用户菜单,个人资料,API & Integrations,生成新令牌,包含列表、订单、消息、报价、付款和个人资料范围。个人访问令牌不会过期。Reverb 要求在 API 工作之前设置账单并手动创建一个列表。
它涵盖了什么? 你自己的商店:从草稿到发布的列表,订单和运输,买家对话,报价,退款请求,付款和商店数据。没有令牌搜索整个市场的是 Reverb Listings 连接器。
哪些工具安装时关闭? reverb_end_listing、reverb_accept_offer、reverb_counter_offer、reverb_respond_to_refund_request 和 reverb_create_refund_request,因为它们会销售、退款或结束列表。仅在 AI 应该使用它们时在连接器页面上打开它们。
下一步
这份指南对你有帮助吗?