README

这是一个用于 decathlon.nl 的 MCP 服务器。荷兰网站使用的格式与 Decathlon 其他地区（包括 IN）不同，因此这是一个单独的 MCP 服务器来处理该问题。

设置

你可以在 claude code 或你最喜欢的支持 stdio 模式的 MCP 客户端中使用 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 服务器实现了四个不同的工具：

• search_suggestions(query) — 搜索词条的自动补全建议，包括匹配的类别和热门查询。

• search_products(query, page) — 产品搜索。返回每个产品的规范化摘要：Decathlon ID（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 会使用退避重试。

产品搜索使用 Next.js RSC 协议（/search 上的 RSC: 1 头），因为没有公开的 JSON 搜索端点；其 flight-data 格式是 Next.js 内部的，如果 Decathlon 升级其技术栈，可能需要更新解析器。产品详细信息和评论端点则是纯 JSON，更稳定。

免责声明

这不是官方项目。目前出于明显原因仅限于只读访问。