README

Este es un servidor MCP para decathlon.nl. El sitio web de los Países Bajos utiliza un formato diferente al del resto de Decathlon (incluido IN), por lo que este es un servidor MCP separado para manejar eso.

Configuración

Puedes configurarlo en Claude Code o en tu cliente MCP favorito en modo stdio con uv (recomendado).

Para Claude Code:

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

O añádelo directamente a tu ~/.claude.json / configuración del cliente:

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

Configuración manual

Requiere Python >= 3.13 y uv.

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

Esto ejecuta el servidor a través de stdio. Apunta cualquier cliente MCP que admita transporte stdio al comando decathlon-mcp.

Detalles

Este servidor MCP implementa cuatro herramientas diferentes:

• search_suggestions(query) — sugerencias de autocompletado para un término de búsqueda, incluyendo categorías coincidentes y consultas populares.

• search_products(query, page) — búsqueda de productos. Devuelve un resumen normalizado por producto: ids de Decathlon (id, model_id, sku_id), título, marca, URL, imagen, precio (con precio original cuando hay descuento), disponibilidad en línea, tallas, calificación y número de reseñas. Usa sku_id con get_product_details y model_id con get_reviews.

• get_product_details(sku_ids[]) — detalles completos para uno o más SKU (en lote): descripción, colores, talla, peso, precio actual vs. precio original, vendedor, opciones de cumplimiento (recogida en tienda / entrega / envío), disponibilidad de stock por tienda, categorías y deportes.

• get_reviews(model_id, page, per_page) — reseñas de clientes con estadísticas agregadas (calificación promedio, % de satisfacción, distribución de estrellas) además de reseñas individuales con indicadores de compra verificada y subcalificaciones por atributo (facilidad de uso, relación calidad-precio, etc.).

Un flujo típico de agente es: search_products para encontrar candidatos → get_product_details para comparar precio/stock/tallas entre variantes → get_reviews para juzgar la calidad.

Notas de implementación

El sitio bloquea suavemente las ráfagas de solicitudes (enfriamiento de ~1–2 minutos durante el cual las páginas vuelven sin datos de producto), por lo que las solicitudes se espacian al menos 3 segundos y search_products reintenta con retroceso cuando una respuesta carece de datos.

La búsqueda de productos utiliza el protocolo RSC de Next.js (encabezado RSC: 1 en /search) ya que no hay un endpoint JSON público de búsqueda; su formato de datos de vuelo es interno de Next.js y puede necesitar actualizaciones del analizador si Decathlon actualiza su stack. Los endpoints de detalles de producto y reseñas son JSON simple y más estables.

Aviso legal

Este no es un proyecto oficial. Actualmente limitado a acceso de solo lectura por razones obvias.