README

이것은 decathlon.nl용 MCP 서버입니다. 네덜란드 웹사이트는 나머지 Decathlon(IN 포함)과 다른 형식을 사용하므로, 이를 처리하기 위한 별도의 MCP 서버입니다.

Setup

claude code 또는 선호하는 MCP 클라이언트에서 uv를 사용하여 stdio 모드로 설정할 수 있습니다(권장).

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"]
    }
  }
}

Manual Setup

Python >= 3.13 및 uv가 필요합니다.

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

이것은 stdio를 통해 서버를 실행합니다. stdio 전송을 지원하는 모든 MCP 클라이언트를 decathlon-mcp 명령에 지정하세요.

Details

이 MCP 서버는 네 가지 도구를 구현합니다:

• search_suggestions(query) — 검색어에 대한 자동 완성 제안으로, 일치하는 카테고리와 인기 검색어를 포함합니다.

• search_products(query, page) — 제품 검색. 제품별로 정규화된 요약을 반환합니다: Decathlon ID(id, model_id, sku_id), 제목, 브랜드, URL, 이미지, 가격(할인 시 원래 가격 포함), 온라인 구매 가능 여부, 사이즈, 평점 및 리뷰 수. get_product_details에는 sku_id를, get_reviews에는 model_id를 사용하세요.

• get_product_details(sku_ids[]) — 하나 이상의 SKU에 대한 전체 세부 정보(배치 처리): 설명, 색상, 사이즈, 무게, 현재 가격 대비 원래 가격, 판매자, 주문 처리 옵션(매장 픽업 / 배송 / 발송), 매장별 재고 가용성, 카테고리 및 스포츠.

• get_reviews(model_id, page, per_page) — 집계 통계(평균 평점, 만족도 %, 별점 분포)가 포함된 고객 리뷰와, 구매 인증 플래그 및 속성별 하위 평점(사용 용이성, 가성비 등)이 포함된 개별 리뷰.

일반적인 에이전트 흐름은 다음과 같습니다: 후보를 찾기 위한 search_products → 변형 간 가격/재고/사이즈를 비교하기 위한 get_product_details → 품질을 판단하기 위한 get_reviews.

Implementation notes

사이트는 요청 폭주를 소프트 차단합니다(제품 데이터 없이 페이지가 반환되는 약 1~2분의 쿨다운). 따라서 요청 간격은 최소 3초로 유지되며, search_products는 응답에 데이터가 없을 때 백오프와 함께 재시도합니다.

제품 검색은 공개 JSON 검색 엔드포인트가 없으므로 Next.js RSC 프로토콜(/search의 RSC: 1 헤더)을 사용합니다. 이 flight-data 형식은 Next.js 내부 전용이므로 Decathlon이 스택을 업그레이드하면 파서 업데이트가 필요할 수 있습니다. 제품 세부 정보 및 리뷰 엔드포인트는 일반 JSON이며 더 안정적입니다.

Disclaimer

이것은 공식 프로젝트가 아닙니다. 명백한 이유로 현재 읽기 전용 액세스로 제한되어 있습니다.