README

Это MCP-сервер для decathlon.nl. Нидерландский сайт использует другой формат, чем остальные сайты Decathlon (включая IN), поэтому для работы с ним создан отдельный MCP-сервер.

Настройка

Вы можете настроить его в Claude Code или в любом удобном MCP-клиенте в режиме stdio с помощью uv (рекомендуется).

Для Claude Code:

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

Или добавьте его напрямую в ваш ~/.claude.json / конфигурацию клиента:

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

Ручная настройка

Требуется Python >= 3.13 и uv.

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

Это запускает сервер через stdio. Укажите любому MCP-клиенту, поддерживающему транспорт stdio, на команду decathlon-mcp.

Подробности

Этот MCP-сервер реализует четыре различных инструмента:

• search_suggestions(query) — автодополнение для поискового запроса, включая соответствующие категории и популярные запросы.

• search_products(query, page) — поиск товаров. Возвращает нормализованную сводку по каждому товару: идентификаторы Decathlon (id, model_id, sku_id), название, бренд, URL, изображение, цену (с исходной ценой при скидке), наличие онлайн, размеры, рейтинг и количество отзывов. Используйте sku_id с get_product_details и model_id с get_reviews.

• get_product_details(sku_ids[]) — полные сведения об одном или нескольких SKU (пакетно): описание, цвета, размер, вес, текущая цена по сравнению с исходной, продавец, варианты выполнения заказа (самовывоз из магазина / доставка / отправка), наличие на складе по магазинам, категории и виды спорта.

• get_reviews(model_id, page, per_page) — отзывы покупателей с агрегированной статистикой (средний рейтинг, процент удовлетворенности, распределение звезд), а также отдельные отзывы с отметками о подтвержденной покупке и под-рейтингами по атрибутам (удобство использования, соотношение цены и качества и т. д.).

Типичный поток агента: search_products для поиска кандидатов → get_product_details для сравнения цены/наличия/размеров по вариантам → get_reviews для оценки качества.

Примечания по реализации

Сайт мягко блокирует всплески запросов (период охлаждения ~1–2 минуты, в течение которого страницы возвращаются без данных о товарах), поэтому запросы отправляются с интервалом не менее 3 секунд, а search_products повторяет попытки с экспоненциальной задержкой, когда в ответе отсутствуют данные.

Поиск товаров использует протокол RSC от Next.js (заголовок RSC: 1 на /search), поскольку публичного JSON-эндпоинта для поиска нет; его формат flight-data является внутренним для Next.js и может потребовать обновления парсера, если Decathlon обновит свой стек. Эндпоинты сведений о товаре и отзывов — это обычный JSON, и они более стабильны.

Отказ от ответственности

Это не официальный проект. В настоящее время доступ ограничен только чтением по очевидным причинам.