README

これは decathlon.nl 用の MCP サーバーです。オランダのウェブサイトは他の 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 経由でサーバーを実行します。stdio トランスポートをサポートする任意の MCP クライアントを decathlon-mcp コマンドに向けてください。

詳細

この MCP サーバーは、4 つの異なるツールを実装しています:

• 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[]) — 1 つ以上の SKU（バッチ処理）の完全な詳細: 説明、色、サイズ、重量、現在価格と元の価格の比較、販売者、フルフィルメントオプション（店舗受け取り / 配送 / 発送）、店舗ごとの在庫状況、カテゴリ、スポーツ。

• get_reviews(model_id, page, per_page) — 顧客レビューと集計統計（平均評価、満足度 %、星の分布）、さらに個別レビュー（購入済みフラグ、属性ごとのサブ評価（使いやすさ、コストパフォーマンスなど））を返します。

典型的なエージェントの流れは、search_products で候補を見つけ、get_product_details でバリエーション間の価格・在庫・サイズを比較し、get_reviews で品質を判断する、というものです。

実装上の注意

サイトはリクエストのバーストをソフトブロックします（約 1〜2 分のクールダウン中は、商品データなしでページが返されます）。そのため、リクエストは少なくとも 3 秒間隔で送信され、search_products はレスポンスにデータが欠けている場合にバックオフ付きで再試行します。

商品検索は、公開された JSON 検索エンドポイントがないため、Next.js の RSC プロトコル（/search の RSC: 1 ヘッダー）を使用します。そのフライトデータ形式は Next.js 内部のものであり、Decathlon がスタックをアップグレードした場合、パーサーの更新が必要になる可能性があります。商品詳細とレビューのエンドポイントはプレーンな JSON であり、より安定しています。

免責事項

これは公式プロジェクトではありません。現在、明らかな理由により読み取り専用アクセスに制限されています。