Reverb

@pipeworx/reverb

Reverb.com 上的实时商品信息，涵盖乐器交易市场上的吉他、音箱、效果器、合成器、鼓和专业音频设备，并提供品牌/型号/年份/饰面/成色以及卖家的标价。

属于 Pipeworx 项目——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• reverb_search(query, ...) — 按器材筛选条件搜索商品（品牌、 型号、产品类型/类别、成色、价格区间、年份范围、地区、 手工制作、排序字段/顺序）。回答“现在一把 20 世纪 60 年代的 Gibson 电吉他卖多少钱，以及是谁在卖”。
• reverb_listing(listing_id) — 获取单件商品的完整信息：卖家描述、 标价和买家价格、报价/库存状态、照片、按地区划分的运费。
• reverb_shop(shop_slug) — 卖家资料：反馈数量、评分、 优选卖家状态、所在地、配送情况。
• reverb_categories(root_slug?) — 类别树，调用方可据此填写 reverb_search 的 product_type / category，无需猜测 slug。

认证

无需密钥。此工具包调用的每个端点都无需令牌即可响应——已于 2026-09-05 验证。只有 Reverb 的账户范围端点（/api/my/*、订单、销售） 需要 OAuth，而这里没有公开这些端点，因此无需 PLATFORM_REVERB_KEY，也不支持 BYOK。

仅提供标价——此处没有已售数据

Reverb 的公开价格指南已停用。/api/priceguide 和 /api/priceguide/transactions 对所有查询均返回：

HTTP 403  { "Error": "This endpoint is no longer publicly available." }

（已于 2026-09-05 验证）。此工具包返回的所有信息都是实时标价， 并非实际成交价，且每个响应都会在其 price_basis 和 sold_data 字段中注明这一点。请勿将其用作可比价格。对于乐器的实际成交价格，Reverb 并非数据来源。

数据来源

• https://api.reverb.com/api/listings/all — 商品搜索。使用的参数： query, make, model, product_type, category, condition, price_min, price_max, currency, year_min, year_max, item_region, ships_to, handmade, sort, order, page, per_page。
• https://api.reverb.com/api/listings/{id} — 商品详情。
• https://api.reverb.com/api/shops/{slug} — 卖家资料。
• https://api.reverb.com/api/categories/flat — 完整类别树（根类别及子类别，共 320 项）。普通的 /api/categories 仅返回 14 个根类别。

文档位于 https://www.reverb-api.com（dev.reverb.com 会重定向至此）。

以下信息可免去重复探索：

• Accept-Version: 3.0 和 Accept: application/hal+json 这两个标头用于 选择 JSON API。缺少它们时，可能会得到 HTML。
• total_pages 的上限为 50，与 total 无关——即使查询结果有 77,081 条， 仍会报告 total_pages: 50。但请求 page=51 仍会返回结果，因此应将此上限视为显示问题，而非分页边界。 reverb_search 会返回说明这一点的 total_pages_note。
• 涉及税费时，price 和 buyer_price 会有所不同；listing_currency 是 卖家的货币，而 price.currency 遵循 currency 参数。
• 商品详情包含店铺的 feedback_count 和 rating_percentage， 搜索响应中不包含这两项。
• 截至 2026-09-05，reverb.com/llms.txt 返回 404，尽管有相反的报告。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "reverb": {
      "url": "https://gateway.pipeworx.io/reverb/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/reverb/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关级工具集中的其他工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点除了列出该工具包自己的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切的范围，也是当天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具让限定范围的连接也能回答本工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中进行路由——无需再添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的 schema 带来的上下文成本超过了路由的价值，不如只连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是，哪一个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/reverb_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"stratocaster","make":"Fender","product_type":"electric-guitars","condition":"used","price_min":1000,"price_max":5000,"sort":"price","order":"asc","per_page":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/reverb_search。查找工具包：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "reverb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-reverb"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-reverb

它通过 stdin/stdout 使用 MCP 协议，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接添加的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Reverb data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT