README

Dies ist ein MCP-Server für decathlon.nl. Die niederländische Website verwendet ein anderes Format als der Rest von Decathlon (einschließlich IN), daher ist dies ein separater MCP-Server, der sich darum kümmert.

Einrichtung

Du kannst dies in Claude Code oder deinem bevorzugten MCP-Client im stdio-Modus mit uv einrichten (empfohlen).

Für Claude Code:

claude mcp add decathlon -- uv run --project /path/to/decathlon-mcp decathlon-mcp

Oder füge es direkt zu deiner ~/.claude.json / Client-Konfiguration hinzu:

{
  "mcpServers": {
    "decathlon": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/decathlon-mcp", "decathlon-mcp"]
    }
  }
}

Manuelle Einrichtung

Erfordert Python >= 3.13 und uv.

git clone <repo-url>
cd decathlon-mcp
uv sync
uv run decathlon-mcp

Dies führt den Server über stdio aus. Weise jeden MCP-Client, der stdio-Transport unterstützt, auf den Befehl decathlon-mcp hin.

Details

Dieser MCP-Server implementiert vier verschiedene Tools:

• search_suggestions(query) — Autovervollständigungsvorschläge für einen Suchbegriff, einschließlich passender Kategorien und beliebter Suchanfragen.

• search_products(query, page) — Produktsuche. Gibt eine normalisierte Zusammenfassung pro Produkt zurück: Decathlon-IDs (id, model_id, sku_id), Titel, Marke, URL, Bild, Preis (mit Originalpreis bei Rabatt), Online-Verfügbarkeit, Größen, Bewertung und Anzahl der Bewertungen. Verwende sku_id mit get_product_details und model_id mit get_reviews.

• get_product_details(sku_ids[]) — vollständige Details für eine oder mehrere SKUs (gebündelt): Beschreibung, Farben, Größe, Gewicht, aktueller Preis vs. Originalpreis, Verkäufer, Erfüllungsoptionen (Abholung im Geschäft / Lieferung / Versand), Lagerverfügbarkeit pro Filiale, Kategorien und Sportarten.

• get_reviews(model_id, page, per_page) — Kundenbewertungen mit aggregierten Statistiken (durchschnittliche Bewertung, Zufriedenheitsprozentsatz, Sternverteilung) sowie einzelne Bewertungen mit Flags für verifizierten Kauf und Unterbewertungen pro Attribut (Benutzerfreundlichkeit, Preis-Leistungs-Verhältnis usw.).

Ein typischer Agentenablauf ist: search_products zum Finden von Kandidaten → get_product_details zum Vergleichen von Preis/Lagerbestand/Größen über Varianten hinweg → get_reviews zur Beurteilung der Qualität.

Implementierungshinweise

Die Website blockiert Bursts von Anfragen weich (~1–2 Minuten Abkühlung, während der Seiten ohne Produktdaten zurückkommen), daher werden Anfragen mindestens 3 Sekunden voneinander entfernt gesendet und search_products wiederholt mit Backoff, wenn einer Antwort Daten fehlen.

Die Produktsuche verwendet das Next.js-RSC-Protokoll (RSC: 1-Header auf /search), da es keinen öffentlichen JSON-Such-Endpunkt gibt; sein Flight-Datenformat ist intern für Next.js und kann Parser-Updates erfordern, wenn Decathlon seinen Stack aktualisiert. Die Endpunkte für Produktdetails und Bewertungen sind einfaches JSON und stabiler.

Haftungsausschluss

Dies ist kein offizielles Projekt. Derzeit aus offensichtlichen Gründen auf schreibgeschützten Zugriff beschränkt.