Guida al connettore9 minuti di lettura31 tool MCP7 lingue

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.

HCA cura del team HelpCodeAggiornato 9 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 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 Gemini in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Whatnot con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. 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, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Whatnot + Gemini

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.

  1. 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.
  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; 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 Gemini

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 mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
  2. Salva il file e riavvia gemini.
  3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
  4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Whatnot.

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. Evasione degli ordini il cui stato è pending_fulfillment; 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 restituisce 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 (buy_it_now o asta), riserva_per_live e se è assegnato a spettacoli imminenti o in diretta…
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 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_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…
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), 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ù recentemente 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 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 cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

Questa guida ti è stata utile?

Collega Whatnot a Gemini in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Whatnot con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. 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 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.

Connettori

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.