In breve
API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni 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 ChatGPT in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Reverb con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.
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 + ChatGPT
API Reverb per venditori di strumenti musicali: gestisci le tue inserzioni 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.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nel negozio dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
REVERB_TOKEN
Passo 1 — Ottieni le credenziali
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 personale non scadono.
Reverb richiede a ogni venditore di avere la fatturazione impostata e almeno un'inserzione creata manualmente su reverb.com prima di utilizzare l'API.
Dove iniziare: reverb_list_orders_awaiting_shipment mostra cosa deve essere spedito. reverb_list_my_listings mostra le tue inserzioni attive (stato tutte le bozze e quelle terminate); reverb_get_shop mostra il negozio e i suoi profili di spedizione.
Inserzioni: crea una bozza con reverb_create_listing (uuid categoria da reverb_list_categories, uuid condizione da reverb_list_listing_conditions, id 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'inserzione. Trova un'inserzione tramite il tuo SKU con 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'inserzione. 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 sulle tue inserzioni; 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 a 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, le inserzioni l'id numerico dell'inserzione, categorie e 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 disponibili 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 validazione 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.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Reverb. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
reverb_list_my_listings | Elenca le tue inserzioni con il loro id, titolo, marca, modello, sku, condizione, prezzo (importo e valuta), inventario e _links (l'inserzione… |
reverb_list_my_drafts | Elenca le tue inserzioni in bozza (create ma non ancora pubblicate) con gli stessi campi di reverb_list_my_listings: id, titolo, marca, modello, sku… |
reverb_get_listing | Leggi un'inserzione per id con i campi da cui è creata un'inserzione: titolo, marca, modello, finitura, anno, descrizione, condizione, categorie… |
reverb_create_listing | Crea un'inserzione 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 una delle tue inserzioni (bozza o attiva): solo i campi forniti cambiano. Usi tipici: prezzo, inventario, descrizione, foto, spedizione… |
reverb_publish_listing | Pubblica un'inserzione in bozza affinché gli acquirenti possano vederla e acquistarla. La bozza deve essere completa (marca e modello noti, categoria, condizione, prezzo, foto… |
reverb_end_listing | Termina un'inserzione attiva affinché non possa più essere acquistata. Motivo not_sold la rimuove semplicemente. Motivo reverb_sale indica che hai trovato l'acquirente su… |
reverb_list_orders | Elenca gli ordini che hai venduto, tutti gli stati: order_number, stato (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, stato (non pagato, pagamento in attesa, in attesa di revisione, bloccato, pagato, spedito, ritirato… |
reverb_ship_order | Segna 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'oggetto è… |
reverb_mark_order_picked_up | Segna 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) accettati da Reverb 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), in modo che l'intero scambio con l'acquirente possa 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) fatte dagli acquirenti sulle tue inserzioni, 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'inserzione 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 una delle tue inserzioni. 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'oggetto 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 contro-offerta: il tuo prezzo e, facoltativamente, un prezzo di spedizione. Una contro-offerta è 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'oggetto è 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'inserzione. 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'inserzione prendono. Una lunga lista; alcune… |
reverb_list_listing_conditions | Elenca le condizioni che il tuo negozio può utilizzare sulle inserzioni (Non funzionante, Scarso, Equo, Buono, Molto Buono, Eccellente, Mint, B-Stock, Nuovo di zecca): uuid… |
Esempi di prompt
- "Quali ordini Reverb sono in attesa di spedizione?"
- "Crea un'inserzione per la mia Gibson Les Paul Standard del 2019 in condizioni Eccellenti a 2.200 USD."
- "Quali offerte da parte degli acquirenti sono aperte sulle mie inserzioni?"
- "Spedisci l'ordine 12345678 con tracciamento UPS 1Z999AA10123456784."
- "Mostrami i miei pagamenti dell'ultimo mese e i loro dettagli."
FAQ
Dove posso ottenere il token? Su reverb.com: menu utente, Il mio profilo, API e integrazioni, Genera nuovo token, con gli ambiti di inserzione, ordine, messaggio, offerta, pagamento e profilo. I token di accesso personale non scadono. Reverb richiede la fatturazione e un'inserzione creata manualmente prima che l'API funzioni.
Cosa copre? Il tuo negozio: inserzioni dalla bozza alla pubblicazione, ordini e spedizioni, conversazioni con gli acquirenti, offerte, richieste di rimborso, pagamenti e dati del negozio. Cercare nell'intero marketplace senza un token è il connettore delle inserzioni Reverb.
Quali strumenti sono installati disattivati? reverb_end_listing, reverb_accept_offer, reverb_counter_offer, reverb_respond_to_refund_request e reverb_create_refund_request, perché vendono, rimborsano o terminano un'inserzione. Attivali nella pagina del connettore solo se l'AI deve usarli.
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
Questa guida ti è stata utile?