In breve
API Venditore Whatnot per i venditori nel marketplace dello shopping dal vivo: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi degli spettacoli e report. Token di accesso personale.
Configurazione guidata
Collega Whatnot a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Whatnot 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 Whatnot
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 → Whatnot, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Whatnot
API Venditore Whatnot per i venditori nel marketplace dello shopping dal vivo: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi degli spettacoli e report. Token di accesso personale.
Configurazione
La configurazione richiede circa 2 minuti.
- Accedi a Whatnot con l'account venditore e apri il pannello di controllo per sviluppatori, scheda Token di accesso personale (https://www.whatnot.com/dashboard/developer?tab=tokens). Solo il proprietario dell'account può creare token.
- Clicca su Genera nuovo token, dagli un nome, scegli una scadenza (da 7 a 90 giorni, una data personalizzata o nessuna scadenza) e le autorizzazioni: lettura e scrittura per inventario, merchandising, ordini e spedizioni, lettura per spettacoli, lettura e scrittura per report, e lettura clienti se l'agente deve vedere i nomi degli acquirenti. L'accesso in scrittura include l'accesso in lettura.
- Copia il token (inizia con
wn_pat_tk_e viene mostrato solo una volta) inWHATNOT_API_TOKEN.
L'API Venditore è ancora contrassegnata come beta da Whatnot: i campi possono cambiare.
Da dove iniziare: whatnot_get_current_user controlla il token. whatnot_list_orders mostra gli ordini recenti; evadi quelli con stato pending_fulfillment. whatnot_list_products elenca il catalogo.
Ordini e spedizioni: whatnot_list_orders, whatnot_get_order, whatnot_list_order_items, whatnot_get_order_item. Ogni articolo dell'ordine appartiene a una spedizione: whatnot_list_shipments, whatnot_get_shipment, whatnot_list_shipment_items. Spedisci con la tua etichetta tramite whatnot_add_tracking_code (id articoli dell'ordine, corriere, codice di tracciamento). whatnot_generate_shipping_label (etichetta Whatnot, potrebbe costare) e whatnot_cancel_order (rimborsa l'acquirente) sono installati disattivati.
Elencare un prodotto: 1) whatnot_list_dimension_profiles per un id profilo pacchetto, 2) whatnot_create_product con titolo, id categoria foglia dalla tassonomia pubblica di Whatnot (https://github.com/Whatnot-Inc/product-taxonomy) e il profilo, 3) whatnot_list_product_variants per gli id delle varianti, 4) whatnot_update_product_variants per i prezzi, 5) whatnot_set_inventory per lo stock, 6) whatnot_update_product_merchandising per scegliere acquisto_immediato o asta e pubblicare. Cambia i prodotti con whatnot_update_product, leggili con whatnot_get_product e whatnot_get_product_variant. whatnot_delete_product è installato disattivato.
Inventario: whatnot_set_inventory (assoluto) e whatnot_adjust_inventory (delta) accettano fino a 10 varianti per chiamata; assegna a ogni articolo una chiave di idempotenza fresca (un UUID) in modo che un retry venga applicato solo una volta.
Spettacoli e merchandising: whatnot_list_shows (stato programmato per impostazione predefinita), whatnot_get_show, whatnot_get_show_analytics, whatnot_get_product_merchandising, whatnot_list_product_shows. Aggiungere un prodotto a uno spettacolo utilizza gli id degli spettacoli (UUID) in whatnot_update_product_merchandising con strategia ADD, REMOVE o REPLACE.
Report: whatnot_generate_report avvia un report finanziario, panoramica analitica o report di livestream; interroga whatnot_get_report o whatnot_list_reports fino a quando lo stato è completato.
Paging: le liste accettano limit (da 1 a 50, predefinito 10) e restituiscono data più next_cursor; passalo come cursor fino a quando non è nullo.
Id e formati: gli id di ordine, prodotto, spedizione e articolo dell'ordine sono cifre (inviati come testo); gli id di variante, spettacolo e report sono UUID. Il denaro è un oggetto con amount come testo in unità intere (19.99) e currency. I tempi sono in ISO 8601 in UTC con millisecondi (2026-11-01T00:00:00.000Z).
Errori e limiti: gli errori sono problem+json con type, title, detail (un errore missing-scope elenca required_scopes: modifica le autorizzazioni del token); un 422 per una richiesta malformata elenca ogni campo sotto detail con loc e msg. Il limite è di 10 richieste al secondo per venditore e app; un 429 riporta Retry-After in secondi.
Prerequisiti: WHATNOT_API_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 Whatnot e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
whatnot_get_current_user | Il venditore dietro il token API: id utente, nome utente e nome visualizzato. Usalo per controllare la connessione |
whatnot_list_orders | Elenca gli ordini venduti dal venditore, i più recenti per impostazione predefinita: id, stato (in attesa, in attesa di evasione, completato, annullato, fallito)… |
whatnot_get_order | Un ordine per id con stato, acquirente, importi e timestamp. Evadi gli ordini il cui stato è in attesa di evasione; gli ordini in attesa non sono pronti… |
whatnot_list_order_items | Articoli di un ordine: id articolo, prodotto, variante, quantità, prezzo e la spedizione a cui appartiene ogni articolo. Paging con cursore, fino a 50 per pagina |
whatnot_get_order_item | Un articolo di un ordine: prodotto, variante, quantità, prezzo e spedizione |
whatnot_cancel_order | Annulla un ordine che non è stato spedito e restituisci l'ordine aggiornato. L'acquirente viene rimborsato e l'annullamento conta contro il venditore.… |
whatnot_list_products | Elenca i prodotti del venditore, i più recenti per impostazione predefinita: id, titolo, descrizione, external_id, categoria, attributi, opzioni, media… |
whatnot_get_product | Un prodotto con la sua categoria, attributi, opzioni, immagini, profilo dimensionale e varianti (id, sku, prezzo, inventario) |
whatnot_create_product | Crea un prodotto nel catalogo del venditore. Whatnot crea una variante per ogni combinazione di valori delle opzioni (una variante senza opzioni).… |
whatnot_update_product | Aggiorna parzialmente un prodotto: titolo, descrizione, id esterno, categoria, attributi, opzioni, immagini o profilo dimensionale. I campi omessi rimangono… |
whatnot_delete_product | Elimina un prodotto dal catalogo del venditore. Non può essere annullato. Installato disattivato |
whatnot_list_product_variants | Varianti di un prodotto: id variante (UUID), sku, external_id, valori delle opzioni selezionate, prezzo, inventario e immagine. Paging con cursore, fino a 50 per… |
whatnot_get_product_variant | Una variante di un prodotto per il suo UUID: sku, opzioni, prezzo, inventario e immagine |
whatnot_update_product_variants | Aggiorna fino a 10 varianti di un prodotto: prezzo (sotto il formato di vendita del prodotto), sku, id esterno, paese di origine o immagine. I campi omessi… |
whatnot_set_inventory | Imposta la quantità disponibile di fino a 10 varianti a un valore assoluto. Ogni articolo necessita di una chiave di idempotenza unica (un nuovo UUID per ogni modifica); un… |
whatnot_adjust_inventory | Cambia la quantità disponibile di fino a 10 varianti per un delta (negativo per ridurre; un risultato inferiore a zero diventa 0). Ogni articolo necessita di una chiave unica… |
whatnot_get_product_merchandising | Come e dove viene venduto un prodotto: transaction_type (acquisto_immediato o asta), riserva_per_live e se è assegnato a spettacoli imminenti o dal vivo… |
whatnot_update_product_merchandising | Imposta il formato di vendita di un prodotto, riservalo per spettacoli dal vivo, o aggiungilo o rimuovilo dagli spettacoli, in una sola chiamata; i campi omessi rimangono invariati.… |
whatnot_list_product_shows | Spettacoli imminenti o dal vivo a cui è assegnato un prodotto, ordinati per inizio programmato (ultimi per primi per impostazione predefinita). Gli spettacoli terminati e annullati sono esclusi.… |
whatnot_list_shipments | Elenca le spedizioni del venditore, le più recenti per impostazione predefinita: id, stato (creato, etichetta_generata, consegnato, in_transito, consegnato, annullato… |
whatnot_get_shipment | Una spedizione: stato, tracciamento, documenti (etichetta), azioni richieste e indirizzo dell'acquirente |
whatnot_list_shipment_items | Articoli attivi di una spedizione: id articoli dell'ordine, prodotti, quantità e profilo dimensionale. Paging con cursore, fino a 50 per pagina |
whatnot_add_tracking_code | Spedisci articoli dell'ordine sotto un codice di tracciamento con l'etichetta del venditore. Gli articoli devono andare allo stesso acquirente e indirizzo e non devono essere stati… |
whatnot_generate_shipping_label | Metti in coda un'etichetta di spedizione Whatnot per una spedizione con le sue impostazioni salvate. 200 significa in coda, non creata; l'etichetta arriva tramite Whatnot… |
whatnot_list_dimension_profiles | I profili dimensionale attivi del venditore (preset di peso e dimensioni del pacchetto): id, nome, peso, dimensioni. Usa un id quando crei un prodotto.… |
whatnot_list_shows | Elenca gli spettacoli del venditore con uno stato (programmato per impostazione predefinita), ordinati per orario di inizio programmato, ultimi per primi per impostazione predefinita: id (UUID), titolo, stato… |
whatnot_get_show | Uno spettacolo per id (UUID): titolo, stato, visibilità, inizio programmato e URL |
whatnot_get_show_analytics | Analisi di uno spettacolo (vendite, spettatori e altre metriche). Uno spettacolo senza numeri finali risponde con metriche nulle e calculation_status… |
whatnot_generate_report | Richiedi l'esecuzione di un report: seller_financial_report (transazioni tra start_date e end_date, predefinito una settimana), analytics_overview_report… |
whatnot_list_reports | Le esecuzioni di report del venditore, richieste più di recente per prime: id, report_type, stato (in attesa, in corso, completato, fallito, annullato)… |
whatnot_get_report | Un'esecuzione di report per id (UUID): stato e, quando completato, il link per scaricare il file |
Esempi di richieste
- "Quali ordini Whatnot dello spettacolo di ieri sera devono ancora essere spediti?"
- "Aggiungi il tracciamento UPS 1Z999AA10123456784 alla spedizione 778899."
- "Imposta l'inventario della variante SKU WN-CARD-PK1 a 50."
- "Come è andato il mio ultimo spettacolo: spettatori, vendite e ricavi?"
- "Genera un report di vendite per ottobre."
Prossimi passi
Questa guida ti è stata utile?