Walmart Marketplace MCP mit Gemini CLI verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Walmart Marketplace, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

Walmart Marketplace + Gemini

Walmart Marketplace API für US-Verkäufer: Bestellungen mit Bestätigung und Versand mit Sendungsverfolgung, Rücksendungen, Artikel- und Katalogsuche, Inventar, Preise, Bulk-Feeds, auf Anfrage Berichte, WFS-Eingangslieferungen und Versand-Einstellungen. Client-ID und Geheimnis.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

WALMART_CLIENT_ID, WALMART_CLIENT_SECRET

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 5 Minuten.

1. Melde dich unter https://developer.walmart.com mit deinem Seller Center-Login an (wähle Marketplace-Verkäufer).
2. Öffne Mein Konto, dann API-Schlüssel (Schlüsselverwaltung) und erstelle oder kopiere die Produktions-Client-ID und das Client-Geheimnis.
3. Füge die Client-ID in WALMART_CLIENT_ID und das Client-Geheimnis in WALMART_CLIENT_SECRET ein.

Der Connector tauscht sie bei POST /v3/token (HTTP Basic, Client-Zugangsdaten) gegen ein Zugriffstoken aus, das 15 Minuten gültig ist, verwendet es bis kurz vor Ablauf und holt sich selbst ein neues. Jeder Aufruf trägt WM_SEC.ACCESS_TOKEN, WM_SVC.NAME und eine neue WM_QOS.CORRELATION_ID. Verwende deine eigenen Verkäufer-Client-Zugangsdaten: Delegierte Zugriffsschlüssel für Lösungsanbieter werden eingestellt (neue können nicht mehr erstellt werden, bestehende funktionieren nach dem 30. April 2027 nicht mehr).

Wo anfangen: walmart_marketplace_list_released_orders (Bestellungen, die auf dich warten), dann walmart_marketplace_get_order. walmart_marketplace_list_items listet deinen Katalog und walmart_marketplace_get_inventory den Bestand eines SKUs.

Bestellungen: walmart_marketplace_list_orders (alle Status), walmart_marketplace_list_released_orders (Zeilen in erstellt), walmart_marketplace_get_order. Eine Zeile geht Erstellt, Bestätigt, Versendet, Zugestellt oder Storniert. Bestätige neue Bestellungen umgehend mit walmart_marketplace_acknowledge_order, dann versende jede Zeile mit walmart_marketplace_ship_order_line (Transporteur, Methode, Sendungsverfolgungsnummer, Versandzeit in Epoch-Millisekunden); der Versand erfasst die Kundenzahlung. walmart_marketplace_cancel_order_line und walmart_marketplace_refund_order_lines sind standardmäßig deaktiviert: eine Stornierung schadet deinen Verkäuferkennzahlen und eine Rückerstattung bewegt Geld. Bestelllisten reichen bis zu 180 Tage zurück, maximal 10.000 Bestellungen und standardmäßig die letzten 7 Tage.

Paging: Bestellungen und Rücksendungen antworten mit meta.nextCursor, einer bereitgestellten Abfragezeichenfolge, die mit ? beginnt. Übergebe sie unverändert als next_cursor und lasse die anderen Filter weg. Artikel verwenden nextCursor (beginnt mit *, gültig 2 Minuten) oder Limit und Offset.

Rücksendungen: walmart_marketplace_list_returns (Status INITIATED, DELIVERED, COMPLETED). walmart_marketplace_refund_return ist deaktiviert, da es dem Kunden eine Rückerstattung gewährt.

Artikel und Katalog: walmart_marketplace_list_items, walmart_marketplace_get_item, walmart_marketplace_count_items, walmart_marketplace_search_my_catalog (dein Katalog mit Filtern wie UNVERÖFFENTLICHTE Artikel) und walmart_marketplace_search_walmart_catalog (der öffentliche Walmart.com-Katalog nach Schlüsselwort, UPC oder GTIN). walmart_marketplace_retire_item ist deaktiviert: das Ausmustern entfernt die Auflistung.

Inventar und Preise: walmart_marketplace_get_inventory, walmart_marketplace_get_inventory_by_ship_node, walmart_marketplace_update_inventory (absolute Menge, Einheit EACH), walmart_marketplace_get_wfs_inventory (Bestand, der von WFS gehalten wird). walmart_marketplace_update_price setzt den BASISpreis eines SKUs in USD (100 Aufrufe pro Stunde); walmart_marketplace_get_promotional_prices zeigt Verkaufspreise an.

Feeds: Bulk-Änderungen erfolgen über Feeds. walmart_marketplace_submit_item_feed und walmart_marketplace_submit_price_feed sind standardmäßig deaktiviert, da ein Feed viele Live-Auflistungen ändert und Bulk-Preis-Feeds pro Stunde und pro Tag begrenzt sind (10 pro Stunde, geteilt durch alle Preis- und Aktions-Feeds). Überprüfe die Ergebnisse mit walmart_marketplace_list_feeds und walmart_marketplace_get_feed_status (Fehler pro Artikel mit include_details).

Berichte: walmart_marketplace_request_report, dann walmart_marketplace_list_report_requests oder walmart_marketplace_get_report_request bis READY, dann walmart_marketplace_get_report_download_url. Status- und Downloadaufrufe sind auf 20 pro Stunde jeweils begrenzt, also warte mehrere Minuten zwischen den Überprüfungen. Der Link ist eine kurzlebige gezippte CSV.

WFS: walmart_marketplace_list_inbound_shipments, walmart_marketplace_list_inbound_shipment_items, walmart_marketplace_create_inbound_shipment_label (Empfangslabels als PDF oder ZPL, kostenlos).

Einstellungen (nur lesen): walmart_marketplace_list_ship_nodes (Versandknoten-IDs), walmart_marketplace_list_carrier_methods, walmart_marketplace_list_shipping_templates, walmart_marketplace_get_lag_time (20 Aufrufe pro Stunde).

Rate Limits: Jede API hat ihren eigenen Token-Bucket (alle Bestellungen 5.000 pro Minute, freigegebene Bestellungen 60 pro Minute, Versand, Bestätigung und Stornierung 60 pro Minute, Inventar 200 pro Minute, Artikel 300 pro Minute). Ein 429 bedeutet, dass der Bucket leer ist; die Header x-current-token-count und X-Next-Replenishment-Time sagen, wann du es erneut versuchen kannst.

Formate: Daten sind ISO 8601 in UTC; Bestelldaten in Antworten sind Epoch-Millisekunden. Geld ist in USD. SKUs sind deine eigenen Verkäufer-SKUs; Walmart-IDs sind purchaseOrderId (Bestellungen), returnOrderId (Rücksendungen), wpid und itemId (Katalog). Fehler kommen als errors.error[] mit Code, Feld und Beschreibung zurück; ein 400 INVALID_REQUEST_HEADER bedeutet normalerweise ein Token- oder Header-Problem.

Schritt 2 — Adapter installieren

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

Schritt 3 — Den Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Walmart Marketplace-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Welche freigegebenen Walmart-Bestellungen müssen heute noch versendet werden?"
• "Zeige Einkaufsbestellung 1234567890123 mit der Versandadresse des Kunden und den Zeilen."
• "Welche SKUs haben weniger als 5 Einheiten auf Lager an meinen Versandknoten?"
• "Setze den Preis von SKU WM-1001 auf 24,99 USD."
• "Bestätige alle freigegebenen Bestellungen von heute und liste die auf, die noch keine Sendungsverfolgung haben."

FAQ

Welche Walmart-Marktplätze werden abgedeckt? Der US Walmart Marketplace (marketplace.walmartapis.com). Walmart Kanada, Mexiko und Chile haben separate APIs und werden nicht abgedeckt.

Brauche ich eine Lösungspartner-App oder Delegierten Zugriff? Nein. Du erstellst deine eigene Client-ID und dein Geheimnis im Walmart Developer Portal mit deinem Verkäufer-Login. Walmart gibt keine neuen Delegierten Zugriffsschlüssel mehr aus.

Kann es Bestellungen stornieren oder Rückerstattungen ausstellen? Die Tools existieren, sind aber standardmäßig deaktiviert: walmart_marketplace_cancel_order_line, walmart_marketplace_refund_order_lines und walmart_marketplace_refund_return. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll; sie fragt dich, jede Änderung zu bestätigen.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden