概要
音楽機器の販売者向けReverb API: 下書き、更新、公開を含む独自のリスト、追跡付きの注文と発送、バイヤーメッセージ、オファー、返金リクエスト、支払い、ショップデータ。個人アクセストークン。
ガイド付きセットアップ
Reverb を Claude、ChatGPT、Copilot に 2 分で接続
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にサインインし、ユーザーメニューを開いてMy Profileに移動します。
- API & Integrationsタブをクリックし、次にGenerate New Tokenをクリックします。
- 名前を入力し、スコープをチェックします:
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で手動で少なくとも1つのリストを作成するよう求めています。
開始する場所: reverb_list_orders_awaiting_shipmentは発送待ちのアイテムを表示します。reverb_list_my_listingsはあなたのライブリストを表示します(すべての追加、下書き、終了したものの状態);reverb_get_shopはショップとその発送プロファイルを表示します。
リスト: reverb_create_listingを使用して下書きを作成します(reverb_list_categoriesからのカテゴリUUID、reverb_list_listing_conditionsからの条件UUID、reverb_get_shopからの発送プロファイルID)、reverb_update_listingで変更し、reverb_publish_listingで販売します。reverb_list_my_draftsは未公開の下書きをリストし、reverb_get_listingは1つのリストを読み取ります。reverb_list_my_listingsとSKUを使用してリストを見つけます。条件が「新品」、「B-ストック」、「ミント」で在庫がある場合のみ、複数のユニットを保持できます。中古品は1点のみで、販売後に再リストすることはできません。在庫を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は1つを拒否します。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のような10進数文字列)、amount_cents、currency、displayを持つオブジェクトです;金額と通貨を送信します。日付はオフセット付きのISO 8601です。ID: 注文は注文番号を使用し、リストは数値のリストID、カテゴリと条件はUUIDを使用します。
ページングとリンク: ReverbはHAL JSONで応答します。リストは_links.nextと_links.prevを持ちます;次が欠けている場合は最後のページにいます。ページとper_pageを使用して移動します。各オブジェクトは、_linksの下にそのオープンなアクションをリストします。
エラー: 401はトークンが間違っているかスコープが不足していることを意味します;404は見つかりません;406はアクションが現在の状態のルールを破ることになります;412はmessageとフィールドごとのerrorsを伴う検証エラーです;429は呼び出しが多すぎます。
レート制限: 読み取りは1分あたり2,000または10分あたり10,000;書き込みは1分あたり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で1つのリストを読み取ります。リストが作成されるフィールド: タイトル、メーカー、モデル、仕上げ、年、説明、条件、カテゴリ… |
reverb_create_listing | あなたのReverbショップに下書きとしてリストを作成します。reverb_publish_listingが呼び出されるまで、バイヤーには表示されません。少なくともタイトルを… |
reverb_update_listing | あなたのリストの1つを更新します(下書きまたはライブ):指定されたフィールドのみが変更されます。典型的な使用例: 価格、在庫、説明、写真、発送… |
reverb_publish_listing | 下書きリストを公開して、バイヤーが見ることができるようにします。下書きは完全でなければなりません(メーカーとモデルが知られている、カテゴリ、条件、価格、写真… |
reverb_end_listing | ライブリストを終了して、もはや購入できないようにします。理由not_soldは単にそれを取り下げます。理由reverb_saleは、あなたがバイヤーを見つけたことを示します… |
reverb_list_orders | あなたが販売した注文をリストします。すべてのステータス: order_number、status(未払い、支払い保留、レビュー待ち、ブロック、支払い済み、発送済み、ピックアップ済み… |
reverb_list_orders_awaiting_shipment | まだ発送されていない支払い済みの注文をリストします。フィールドはreverb_list_ordersと同じです(order_number、title、quantity、buyer_name… |
reverb_get_order | 注文番号で1つの販売された注文を読み取ります: order_number、status(未払い、支払い保留、レビュー待ち、ブロック、支払い済み、発送済み、ピックアップ済み… |
reverb_ship_order | 支払い済みの注文を発送済みとしてマークします。キャリアと追跡番号を使用します。send_notificationがtrueの場合、Reverbはバイヤーにアイテムが… |
reverb_mark_order_picked_up | ローカルピックアップ注文をバイヤーによってピックアップされたとしてマークします(発送方法がローカルの注文)。注文のステータスはpicked_upになります。これを使用するのは… |
reverb_list_shipping_providers | 注文が発送済みとしてマークされたときにReverbが受け入れる発送プロバイダー(キャリア)をリストします。プロバイダー名はリストに正確に記載されている通りに使用します… |
reverb_list_conversations | Reverb上のメッセージ会話をリストします。それぞれにIDが付いており(読み取るか回答するために必要)、_linksがあります。unread_onlyがtrueの場合は… |
reverb_get_conversation | 1つの会話を詳細に読み取ります。メッセージは時系列で(古いものから)表示され、バイヤーとの全体のやり取りが… |
reverb_send_message | 既存の会話に返信します。相手はReverbでメッセージをすぐに受け取り、取り消すことはできないので、慎重に書いてください… |
reverb_list_offers | あなたのリストに対してバイヤーが行ったアクティブなオファー(Reverbはこれを交渉と呼びます)をリストします。それぞれにreverb_get_offer用のIDと回答が… |
reverb_get_offer | 1つのオファー(交渉)の詳細をIDで読み取ります: リスト上のオファー、これまでの提示価格と現在の状態、_linksへのリンク… |
reverb_decline_offer | あなたのリストの1つに対するバイヤーのオファーを拒否します。交渉は販売なしで終了し、拒否は取り消すことはできません;価格は… |
reverb_accept_offer | バイヤーのオファーを受け入れます。これは拘束力があります: あなたは提示された価格と発送価格でアイテムを販売することに同意し、バイヤーはすぐに支払うことができます… |
reverb_counter_offer | バイヤーのオファーに対してカウンターオファーを行います: あなたの価格と、オプションで発送価格。バイヤーが受け入れた場合、カウンターオファーは拘束力があります… |
reverb_list_refund_requests | あなたの販売に対する返金リクエストをリストします。デフォルトではアクティブなもの(pending_seller_responseおよび条件付き承認): ID、状態、金額… |
reverb_respond_to_refund_request | 返金リクエストに回答します: conditionally_approved(アイテムが戻ったら返金します;リクエストはオープンのままです)、approved(今すぐ返金… |
reverb_create_refund_request | 売上の1つに対して返金を開始します。完全または部分的なもの。条件付き承認として作成されます;お金は… |
reverb_list_payouts | Reverbがあなたの銀行口座に送った支払いをリストします: 各支払いの合計(金額と通貨)、created_at、updated_atおよび_links.line_items… |
reverb_list_payout_line_items | 1つの支払いの行をリストします。1注文ごと: order_id、sale_date、sale_price、payout_currencyおよび手数料(selling_fee… |
reverb_get_shop | あなたのショップを読み取ります: ID、名前、説明、shipping_profiles[](IDと名前)、これらのIDはリストのshipping_profile_idに入ります。発送… |
reverb_list_categories | すべてのReverbカテゴリをUUIDと名前のフラットなリストとしてリストします。UUIDはリストのカテゴリが取るものです。長いリストです;いくつかは… |
reverb_list_listing_conditions | あなたのショップがリストに使用できる条件をリストします(動作しない、悪い、普通、良い、非常に良い、優れた、ミント、B-ストック、新品): UUID… |
例のプロンプト
- "発送待ちのReverb注文はどれですか?"
- "2019年製のGibson Les Paul Standardを状態「非常に良い」で2,200 USDの下書きリストを作成してください。"
- "私のリストに対するバイヤーからのオープンなオファーはどれですか?"
- "注文12345678をUPS追跡番号1Z999AA10123456784で発送してください。"
- "先月の私の支払いとその内訳を表示してください。"
次のステップ
このガイドは役に立ちましたか?