DomingosNgongo/walmart-mcp

Was macht walmart-mcp?

🛒 Verbinde KI-Agenten mit dem Walmart-Ökosystem über das Modellkontextprotokoll für Echtzeit-Datenzugriff und erweiterte Produktsuchfunktionen.

Funktionen

• Produktsuche: Suche nach Produkten anhand von Schlüsselwörtern, Kategorien oder Marken
• Preisabfragen: Rufe aktuelle Preise, Angebote und Rabatte ab
• Lagerbestandsprüfung: Überprüfe die Verfügbarkeit in verschiedenen Walmart-Filialen
• Produktdetails: Rufe detaillierte Informationen wie Beschreibungen, Bewertungen und Rezensionen ab
• Kategorienavigation: Durchsuche Produktkategorien und Unterkategorien

Voraussetzungen

• Ein Walmart-API-Schlüssel (kostenlos auf Walmart Developer Portal erhältlich)
• Eine Umgebung, die MCP (Model Context Protocol) unterstützt (z. B. Claude Code, Cursor, Codex)

Installation

1. Klone das Repository:

   git clone https://github.com/DomingosNgongo/walmart-mcp.git
   

2. Installiere die Abhängigkeiten:

   cd walmart-mcp
   npm install
   

3. Konfiguriere deinen API-Schlüssel:

   export WALMART_API_KEY="dein-api-schlüssel"
   

4. Starte den MCP-Server:

   npm start
   

Verwendung

Sobald der Server läuft, können AI-Agenten über MCP mit folgenden Beispielbefehlen interagieren:

• Suche nach Produkten: search products for "Laptop"
• Abfrage von Produktdetails: get product details for ID "123456789"
• Prüfung der Verfügbarkeit: check availability for product ID "123456789"

API-Referenz

Tools

• search_products

  • Parameter: query (string), limit (number, optional)
  • Beschreibung: Suche Produkte anhand einer Suchanfrage

• get_product_details

  • Parameter: product_id (string)
  • Beschreibung: Rufe detaillierte Informationen zu einem bestimmten Produkt ab

• check_availability

  • Parameter: product_id (string), zip_code (string, optional)
  • Beschreibung: Prüfe die Verfügbarkeit eines Produkts in einer Region

Konfiguration

Variable	Beschreibung	Erforderlich
WALMART_API_KEY	Dein Walmart-API-Schlüssel	Ja
MCP_PORT	Port für den MCP-Server (Standard: 3000)	Nein

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex
• Andere MCP-kompatible AI-Agenten

Lizenz

MIT