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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Whatnot con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 + 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.
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Whatnot. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?