In breve
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.
Configurazione guidata
Collega Whatnot a Meta Muse in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Whatnot con la configurazione guidata e aggiungi il tuo URL MCP a Meta Muse. 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, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Whatnot + Meta Muse
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.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
WHATNOT_API_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti.
- Accedi a Whatnot con l'account venditore e apri il dashboard 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; soddisfa 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 (rimborso all'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 buy_it_now 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 richiedono limit (da 1 a 50, predefinito 10) e restituiscono data più next_cursor; passalo come cursor fino a quando non è nullo.
Ids e formati: gli id di ordine, prodotto, spedizione e articolo dell'ordine sono numeri (inviateli 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.
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 Muse
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.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Whatnot.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
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. Evasione degli ordini il cui stato è pending_fulfillment; 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 restituisce 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 (buy_it_now o asta), riserva_per_live e se è assegnato a spettacoli imminenti o in diretta… |
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 in diretta a cui è assegnato un prodotto, 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… |
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), 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ù recentemente 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 prompt
- "Quali ordini di 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 vendita per ottobre."
FAQ
Da dove proviene il token? Dashboard per sviluppatori di Whatnot, scheda Token di accesso personale, creato dal proprietario dell'account con le autorizzazioni necessarie agli strumenti. Viene mostrato una sola volta. L'API venditore è ancora contrassegnata come beta da Whatnot.
Cosa copre? 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.
Quali strumenti sono installati disattivati? whatnot_cancel_order, whatnot_delete_product e whatnot_generate_shipping_label. Attivali nella pagina del connettore solo se l'AI deve usarli.
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?