Guida al connettore8 minuti di lettura31 tool MCP7 lingue

Whatnot MCP: ordini, inventario e dirette

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.

HCA cura del team HelpCodeAggiornato 8 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Whatnot

Whatnot

Whatnot Seller API for sellers on the live shopping marketplace: orders, order items, shipments and tracking codes, products and variants, inventory, merchandising for buy it now, auctions and shows, show analytics and reports. Personal access token.

tool

31

Regione

INTL

Categoria

E-commerce

Autenticazione

Bearer Token

Env vars richieste

WHATNOT_API_TOKEN
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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.

Whatnot · live via MCP
Condividi
Opus 4.7

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.

  1. 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.
  2. 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.
  3. Copia il token (inizia con wn_pat_tk_ e viene mostrato solo una volta) in WHATNOT_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

StrumentoCosa fa
whatnot_get_current_userIl venditore dietro il token API: id utente, nome utente e nome visualizzato. Usalo per controllare la connessione
whatnot_list_ordersElenca gli ordini venduti dal venditore, i più recenti per impostazione predefinita: id, stato (in attesa, in attesa di evasione, completato, annullato, fallito)…
whatnot_get_orderUn 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_itemsArticoli 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_itemUn articolo di un ordine: prodotto, variante, quantità, prezzo e spedizione
whatnot_cancel_orderAnnulla un ordine che non è stato spedito e restituisci l'ordine aggiornato. L'acquirente viene rimborsato e l'annullamento conta contro il venditore.…
whatnot_list_productsElenca i prodotti del venditore, i più recenti per impostazione predefinita: id, titolo, descrizione, external_id, categoria, attributi, opzioni, media…
whatnot_get_productUn prodotto con la sua categoria, attributi, opzioni, immagini, profilo dimensionale e varianti (id, sku, prezzo, inventario)
whatnot_create_productCrea un prodotto nel catalogo del venditore. Whatnot crea una variante per ogni combinazione di valori delle opzioni (una variante senza opzioni).…
whatnot_update_productAggiorna parzialmente un prodotto: titolo, descrizione, id esterno, categoria, attributi, opzioni, immagini o profilo dimensionale. I campi omessi rimangono…
whatnot_delete_productElimina un prodotto dal catalogo del venditore. Non può essere annullato. Installato disattivato
whatnot_list_product_variantsVarianti 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_variantUna variante di un prodotto per il suo UUID: sku, opzioni, prezzo, inventario e immagine
whatnot_update_product_variantsAggiorna 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_inventoryImposta 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_inventoryCambia 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_merchandisingCome 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_merchandisingImposta 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_showsSpettacoli 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_shipmentsElenca le spedizioni del venditore, le più recenti per impostazione predefinita: id, stato (creato, etichetta_generata, consegnato, in_transito, consegnato, annullato…
whatnot_get_shipmentUna spedizione: stato, tracciamento, documenti (etichetta), azioni richieste e indirizzo dell'acquirente
whatnot_list_shipment_itemsArticoli attivi di una spedizione: id articoli dell'ordine, prodotti, quantità e profilo dimensionale. Paging con cursore, fino a 50 per pagina
whatnot_add_tracking_codeSpedisci 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_labelMetti 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_profilesI 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_showsElenca 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_showUno spettacolo per id (UUID): titolo, stato, visibilità, inizio programmato e URL
whatnot_get_show_analyticsAnalisi di uno spettacolo (vendite, spettatori e altre metriche). Uno spettacolo senza numeri finali risponde con metriche nulle e calculation_status…
whatnot_generate_reportRichiedi l'esecuzione di un report: seller_financial_report (transazioni tra start_date e end_date, predefinito una settimana), analytics_overview_report…
whatnot_list_reportsLe esecuzioni di report del venditore, richieste più di recente per prime: id, report_type, stato (in attesa, in corso, completato, fallito, annullato)…
whatnot_get_reportUn'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?

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.

Guide correlate

Connettori

Collegare Whatnot MCP a ChatGPT: ordini e scorte

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.

Connettori

Collegare Whatnot MCP a Claude: ordini e dirette

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.

Connettori

Collegare Whatnot MCP a Microsoft Copilot

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.

Connettori

Collegare Whatnot MCP a Cursor: prodotti e ordini

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.

Connettori

Collegare Whatnot MCP a Gemini CLI: ordini e dirette

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.

Connettori

Collegare Whatnot MCP a Meta Muse: ordini e scorte

API venditore di Whatnot per i venditori nel marketplace di live shopping: ordini, articoli dell'ordine, spedizioni e codici di tracciamento, prodotti e varianti, inventario, merchandising per acquisto immediato, aste e spettacoli, analisi e report degli spettacoli. Token di accesso personale.