Reverb

@pipeworx/reverb

Reverb.com の掲載情報をリアルタイムで取得します。楽器マーケットプレイスのギター、 アンプ、ペダル、シンセ、ドラム、プロオーディオを、メーカー／モデル／年式／仕上げ／状態 および販売者の希望価格とともに表示します。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• reverb_search(query, ...) — ギアのフィルター（メーカー、 モデル、product_type／category、状態、価格帯、年式の範囲、地域、 ハンドメイド、並べ替え／順序）を使った掲載情報の検索です。「1960年代の Gibson のエレキはいくらで出品されていて、誰が販売しているか」に答えます。
• reverb_listing(listing_id) — 1件の掲載情報を詳細に表示します。販売者の説明、 希望価格と購入者価格、オファー／在庫状況、写真、地域別の送料が含まれます。
• reverb_shop(shop_slug) — 販売者のプロフィールです。フィードバック数、評価、 優先販売者ステータス、所在地、配送方針が含まれます。
• reverb_categories(root_slug?) — カテゴリーのツリーを取得します。呼び出し元はスラッグを推測せずに reverb_search の product_type／category を指定できます。

認証

キーは不要です。このパックが呼び出すすべてのエンドポイントはトークンなしで応答します。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 はここにリダイレクトされます）。

再調査の手間を省くための注意点：

• JSON API を選択するには、Accept-Version: 3.0 と Accept: application/hal+json のヘッダーが必要です。 これらがない場合、HTML が返されることがあります。
• total_pages は total に関係なく50に制限されています。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 サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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