Collegare Walmart Marketplace MCP a Gemini CLI

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Walmart Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Walmart Marketplace + Gemini

API di Walmart Marketplace per venditori statunitensi: ordini con conferma e spedizione con tracciamento, resi, ricerca di articoli e catalogo, inventario, prezzi, feed in blocco, report su richiesta, spedizioni in entrata WFS e impostazioni di spedizione. Client ID e segreto.

Requisiti

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:

WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti.

1. Accedi a https://developer.walmart.com con il tuo login di Seller Center (scegli venditore Marketplace).
2. Apri Il mio account, poi Chiavi API (gestione chiavi) e crea o copia il client ID e il client secret di produzione.
3. Incolla il client ID in WALMART_CLIENT_ID e il client secret in WALMART_CLIENT_SECRET.

Il connettore li scambia a POST /v3/token (HTTP Basic, credenziali client) per un token di accesso che dura 15 minuti, lo riutilizza fino a poco prima della scadenza e ne recupera uno nuovo autonomamente. Ogni chiamata porta WM_SEC.ACCESS_TOKEN, WM_SVC.NAME e un nuovo WM_QOS.CORRELATION_ID. Usa le tue credenziali di venditore: le chiavi di Accesso Delegato per i fornitori di soluzioni vengono ritirate (non possono più essere create nuove, quelle esistenti smetteranno di funzionare dopo il 30 aprile 2027).

Dove iniziare: walmart_marketplace_list_released_orders (ordini in attesa), poi walmart_marketplace_get_order. walmart_marketplace_list_items elenca il tuo catalogo e walmart_marketplace_get_inventory lo stock di uno SKU.

Ordini: walmart_marketplace_list_orders (tutti gli stati), walmart_marketplace_list_released_orders (righe in Creata), walmart_marketplace_get_order. Una riga passa a Creata, Confermata, Spedita, Consegnata o Annullata. Conferma prontamente i nuovi ordini con walmart_marketplace_acknowledge_order, poi spediscili con walmart_marketplace_ship_order_line (corriere, metodo, numero di tracciamento, tempo di spedizione in millisecondi epoch); la spedizione registra il pagamento del cliente. walmart_marketplace_cancel_order_line e walmart_marketplace_refund_order_lines sono installati disattivati: un annullamento danneggia le tue metriche di venditore e un rimborso sposta denaro. Le liste degli ordini raggiungono un massimo di 180 giorni, al massimo 10.000 ordini, e predefiniti agli ultimi 7 giorni.

Paging: ordini e resi rispondono con meta.nextCursor, una stringa di query pronta che inizia con ?. Passala invariata come next_cursor e lascia fuori gli altri filtri. Gli articoli usano nextCursor (inizia con *, valido 2 minuti) o limit e offset.

Resi: walmart_marketplace_list_returns (stati INIZIATI, CONSEGNATI, COMPLETATI). walmart_marketplace_refund_return è disattivato perché rimborsa il cliente.

Articoli e catalogo: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (il tuo catalogo con filtri come articoli NON PUBBLICATI) e walmart_marketplace_search_walmart_catalog (il catalogo pubblico di Walmart.com per parola chiave, UPC o GTIN). walmart_marketplace_retire_item è disattivato: ritirare rimuove l'elenco.

Inventario e prezzi: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (quantità assoluta, unità OGNUNO), walmart_marketplace_get_wfs_inventory (stock detenuto da WFS). walmart_marketplace_update_price imposta il prezzo BASE di uno SKU in USD (100 chiamate all'ora); walmart_marketplace_get_promotional_prices mostra i prezzi in offerta.

Feed: le modifiche in blocco passano attraverso i feed. walmart_marketplace_submit_item_feed e walmart_marketplace_submit_price_feed sono installati disattivati, perché un feed modifica molti elenchi attivi e i feed di prezzo in blocco sono limitati per ora e per giorno (10 all'ora, condivisi da tutti i feed di prezzo e promozione). Controlla i risultati con walmart_marketplace_list_feeds e walmart_marketplace_get_feed_status (errori per articolo con include_details).

Report: walmart_marketplace_request_report, poi walmart_marketplace_list_report_requests o walmart_marketplace_get_report_request fino a PRONTO, poi walmart_marketplace_get_report_download_url. Le chiamate di stato e download sono limitate a 20 all'ora ciascuna, quindi aspetta diversi minuti tra i controlli. Il link è un CSV compresso a breve termine.

WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (etichette di ricezione in PDF o ZPL, gratuite).

Impostazioni (solo lettura): walmart_marketplace_list_ship_nodes (id dei nodi di spedizione), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 chiamate all'ora).

Limiti di frequenza: ogni API ha il proprio bucket di token (tutti gli ordini 5.000 al minuto, ordini rilasciati 60 al minuto, spedizione, conferma e annullamento 60 al minuto, inventario 200 al minuto, articoli 300 al minuto). Un 429 significa che il bucket è vuoto; le intestazioni x-current-token-count e X-Next-Replenishment-Time indicano quando riprovare.

Formati: le date sono ISO 8601 in UTC; le date degli ordini nelle risposte sono millisecondi epoch. Il denaro è in USD. Gli SKU sono i tuoi SKU di venditore; gli id di Walmart sono purchaseOrderId (ordini), returnOrderId (resi), wpid e itemId (catalogo). Gli errori tornano come errors.error[] con codice, campo e descrizione; un 400 INVALID_REQUEST_HEADER di solito significa un problema di token o intestazione.

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 Walmart Marketplace.

Strumenti disponibili

Esempi di prompt

• "Quali ordini Walmart rilasciati devono ancora essere spediti oggi?"
• "Mostra l'ordine di acquisto 1234567890123 con l'indirizzo di spedizione del cliente e le righe."
• "Quali SKU hanno meno di 5 unità in stock nei miei nodi di spedizione?"
• "Imposta il prezzo dello SKU WM-1001 a 24,99 USD."
• "Conferma tutti gli ordini rilasciati di oggi e elenca quelli che mancano ancora di tracciamento."

FAQ

Quali marketplace Walmart copre? Il Walmart Marketplace statunitense (marketplace.walmartapis.com). Walmart Canada, Messico e Cile hanno API separate e non sono coperte.

Ho bisogno di un'app di fornitore di soluzioni o di Accesso Delegato? No. Crei il tuo client ID e segreto nel Walmart Developer Portal con il tuo login da venditore. Walmart non emette più nuove chiavi di Accesso Delegato.

Può annullare ordini o emettere rimborsi? Gli strumenti esistono ma sono installati disattivati: walmart_marketplace_cancel_order_line, walmart_marketplace_refund_order_lines e walmart_marketplace_refund_return. Attivali nella pagina del connettore solo se l'IA deve usarli; ti chiede di confermare ogni modifica.

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

• Pagina di atterraggio del connettore
• Collegati a Claude