In breve
Reverb API per venditori di strumenti musicali: elenchi propri con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.
Configurazione guidata
Collega Reverb a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Reverb con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Reverb
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Reverb, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Reverb
Reverb API per venditori di strumenti musicali: elenchi propri con bozza, aggiornamento e pubblicazione, ordini e spedizioni con tracciamento, messaggi degli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Token di accesso personale.
Configurazione
La configurazione richiede circa 3 minuti.
- Accedi a reverb.com, apri il menu utente e vai su Il mio profilo.
- Clicca sulla scheda API e integrazioni, poi Genera nuovo token.
- Inserisci un nome e seleziona gli ambiti:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutseread_profile. Un strumento il cui ambito è mancante viene rifiutato. - Copia il token in
REVERB_TOKEN. I token di accesso personali non scadono.
Reverb richiede a ogni venditore di avere la fatturazione impostata e almeno un elenco creato a mano su reverb.com prima di utilizzare l'API.
Da dove iniziare: reverb_list_orders_awaiting_shipment mostra cosa deve essere spedito. reverb_list_my_listings mostra i tuoi elenchi attivi (stato di tutte le aggiunte, bozze e quelle terminate); reverb_get_shop mostra il negozio e i suoi profili di spedizione.
Elenchi: crea una bozza con reverb_create_listing (uuid della categoria da reverb_list_categories, uuid della condizione da reverb_list_listing_conditions, id del profilo di spedizione da reverb_get_shop), modificala con reverb_update_listing, e mettila in vendita con reverb_publish_listing. reverb_list_my_drafts elenca le bozze non pubblicate e reverb_get_listing legge un elenco. Trova un elenco con il tuo SKU usando reverb_list_my_listings e sku. Solo le condizioni Nuovo di zecca, B-Stock e Mint con inventario possono contenere più di un'unità; un articolo usato è un pezzo singolo e non può essere rimesso in vendita una volta venduto. Impostare l'inventario a 0 termina l'elenco. reverb_end_listing è installato disattivato.
Ordini: reverb_list_orders (tutti, filtra per ultima modifica), reverb_list_orders_awaiting_shipment, reverb_get_order. Spedisci solo quando lo stato è pagato, con reverb_ship_order (fornitore da reverb_list_shipping_providers e il numero di tracciamento); i ritiri locali sono chiusi con reverb_mark_order_picked_up. Le etichette di spedizione non vengono acquistate tramite questo connettore.
Messaggi e offerte: reverb_list_conversations, reverb_get_conversation e reverb_send_message gestiscono i messaggi degli acquirenti. reverb_list_offers e reverb_get_offer leggono le offerte sui tuoi elenchi; reverb_decline_offer rifiuta una. reverb_accept_offer e reverb_counter_offer sono installati disattivati, perché entrambi ti impegnano a un prezzo.
Rimborsi e pagamenti: reverb_list_refund_requests legge le richieste di rimborso. reverb_respond_to_refund_request e reverb_create_refund_request sono installati disattivati: approvare un rimborso accredita l'acquirente e addebita te contemporaneamente. reverb_list_payouts e reverb_list_payout_line_items leggono quanto Reverb ha pagato al tuo conto bancario e le commissioni per ordine.
Formati: il denaro è un oggetto con amount (stringa decimale come 95.00), amount_cents, currency e display; invia importo e valuta. Le date sono in ISO 8601 con un offset. Id: gli ordini usano il numero d'ordine, gli elenchi l'id numerico dell'elenco, le categorie e le condizioni un uuid.
Paging e link: Reverb risponde in HAL JSON. Le liste portano _links.next e _links.prev; quando il prossimo è mancante sei nell'ultima pagina. Usa page e per_page per muoverti. Ogni oggetto elenca anche le azioni aperte a esso sotto _links.
Errori: 401 significa che il token è errato o manca dell'ambito; 404 non trovato; 406 l'azione violerebbe una regola dello stato attuale; 412 un errore di convalida con message e errors per campo; 429 troppe chiamate.
Limiti di frequenza: letture 2.000 al minuto o 10.000 ogni 10 minuti; scritture 600 al minuto o 3.000 ogni 10 minuti. Evita di sincronizzare l'intero negozio tutto in una volta.
Sandbox: sandbox.reverb.com è un sito separato con i propri account e token; questo connettore chiama l'API di produzione.
Prerequisiti: REVERB_TOKEN
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli Reverb e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
reverb_list_my_listings | Elenca i tuoi elenchi con il loro id, titolo, marca, modello, sku, condizione, prezzo (importo e valuta), inventario e _links (l'elenco… |
reverb_list_my_drafts | Elenca le tue bozze di elenco (create ma non ancora pubblicate) con gli stessi campi di reverb_list_my_listings: id, titolo, marca, modello, sku… |
reverb_get_listing | Leggi un elenco per id con i campi da cui è creato un elenco: titolo, marca, modello, finitura, anno, descrizione, condizione, categorie… |
reverb_create_listing | Crea un elenco come bozza nel tuo negozio Reverb. Non è visibile agli acquirenti fino a quando non viene chiamato reverb_publish_listing. Fornisci almeno un titolo… |
reverb_update_listing | Aggiorna uno dei tuoi elenchi (bozza o attivo): solo i campi forniti cambiano. Usi tipici: prezzo, inventario, descrizione, foto, spedizione… |
reverb_publish_listing | Pubblica un elenco in bozza affinché gli acquirenti possano vederlo e acquistarlo. La bozza deve essere completa (marca e modello noti, categoria, condizione, prezzo, foto… |
reverb_end_listing | Termina un elenco attivo affinché non possa più essere acquistato. Il motivo not_sold lo rimuove semplicemente. Il motivo reverb_sale indica che hai trovato l'acquirente su… |
reverb_list_orders | Elenca gli ordini che hai venduto, tutti gli stati: order_number, status (non pagato, pagamento in attesa, in attesa di revisione, bloccato, pagato, spedito, ritirato… |
reverb_list_orders_awaiting_shipment | Elenca gli ordini pagati che devono ancora essere spediti, con gli stessi campi di reverb_list_orders (order_number, titolo, quantità, nome_acquirente… |
reverb_get_order | Leggi un ordine venduto per numero d'ordine: order_number, status (non pagato, pagamento in attesa, in attesa di revisione, bloccato, pagato, spedito, ritirato… |
reverb_ship_order | Contrassegna un ordine pagato come spedito con il corriere e il numero di tracciamento. Con send_notification true Reverb invia un'email all'acquirente che l'articolo è… |
reverb_mark_order_picked_up | Contrassegna un ordine di ritiro locale come ritirato dall'acquirente (ordini con shipping_method locale). Lo stato dell'ordine diventa picked_up. Usalo solo… |
reverb_list_shipping_providers | Elenca i fornitori di spedizione (corrieri) che Reverb accetta quando un ordine è contrassegnato come spedito. Usa il nome del fornitore esattamente come elencato in… |
reverb_list_conversations | Elenca le tue conversazioni di messaggi su Reverb, ciascuna con il suo id (necessario per leggerla o rispondere) e _links. Con unread_only true solo… |
reverb_get_conversation | Leggi una conversazione in dettaglio, con i suoi messaggi in ordine cronologico (dal più vecchio al più recente), così l'intero scambio con l'acquirente può essere… |
reverb_send_message | Rispondi in una conversazione esistente. L'altra parte riceve il messaggio su Reverb immediatamente e non può essere ritirato, quindi scrivilo come il… |
reverb_list_offers | Elenca le offerte attive (Reverb le chiama negoziazioni) che gli acquirenti hanno fatto sui tuoi elenchi, ciascuna con il suo id per reverb_get_offer e la risposta… |
reverb_get_offer | Leggi i dettagli di un'offerta (negoziazione) per id: l'elenco su cui si trova, i prezzi offerti finora e il suo stato attuale, con _links a… |
reverb_decline_offer | Rifiuta un'offerta di un acquirente su uno dei tuoi elenchi. La negoziazione termina senza una vendita e il rifiuto non può essere ritirato; nessun prezzo è… |
reverb_accept_offer | Accetta un'offerta di un acquirente. Questo è vincolante: accetti di vendere l'articolo al prezzo offerto e al prezzo di spedizione, e l'acquirente può pagare subito.… |
reverb_counter_offer | Rispondi a un'offerta di un acquirente con un controfferta: il tuo prezzo e, facoltativamente, un prezzo di spedizione. Un controfferta è vincolante se l'acquirente accetta… |
reverb_list_refund_requests | Elenca le richieste di rimborso sulle tue vendite, per impostazione predefinita quelle attive (pending_seller_response e conditionally_approved): id, stato, importo… |
reverb_respond_to_refund_request | Rispondi a una richiesta di rimborso: conditionally_approved (restituirai una volta che l'articolo è tornato; la richiesta rimane aperta), approved (rimborso ora… |
reverb_create_refund_request | Avvia un rimborso su uno dei tuoi ordini venduti come venditore, totale o parziale. Viene creato come condizionatamente approvato; il denaro si muove quando il… |
reverb_list_payouts | Elenca i pagamenti che Reverb ha inviato al tuo conto bancario: per pagamento totale (importo e valuta), created_at, updated_at e _links.line_items… |
reverb_list_payout_line_items | Elenca le righe di un pagamento, una per ordine: order_id, sale_date, sale_price, payout_currency e le commissioni addebitate (selling_fee… |
reverb_get_shop | Leggi il tuo negozio: id, nome, descrizione e shipping_profiles[] (id e nome), i cui id vanno in shipping_profile_id di un elenco. Spedizione… |
reverb_list_categories | Elenca tutte le categorie Reverb come un'unica lista piatta con il loro uuid e nome. L'uuid è ciò che le categorie di un elenco prendono. Una lunga lista; alcune… |
reverb_list_listing_conditions | Elenca le condizioni che il tuo negozio può utilizzare sugli elenchi (Non funzionante, Scarso, Equo, Buono, Molto buono, Eccellente, Mint, B-Stock, Nuovo di zecca): uuid… |
Esempi di richieste
- "Quali ordini Reverb sono in attesa di spedizione?"
- "Crea un elenco per la mia Gibson Les Paul Standard del 2019 in condizioni Eccellenti a 2.200 USD."
- "Quali offerte da parte degli acquirenti sono aperte sui miei elenchi?"
- "Spedisci l'ordine 12345678 con tracciamento UPS 1Z999AA10123456784."
- "Mostrami i miei pagamenti dell'ultimo mese e i loro dettagli."
Prossimi passi
Questa guida ti è stata utile?