Skip to main content
Glama
deenesjakoruzh
samiashi

chrono24-mcp

by samiashi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

chrono24-mcp

npm CI License: MIT

适用于任何支持 MCP 的 LLM 客户端的 Chrono24 手表市场工具——Claude Code、Claude Desktop、Codex、Cursor、Windsurf 等。

搜索列表，按价格/地点/卖家类型筛选，然后在不离开聊天的情况下获取完整的手表详情（参考号、机芯、口径、盒子和文件、经销商信息、照片）。

search_listings("Rolex Submariner", { sort: "price_asc" })
  -> 60 cards, totalCount 9145, USD prices
get_watch("48091925")
  -> Rolex Submariner Date, ref 16610, $10,307, caliber 3135, box+papers, 16 photos

工作原理

Chrono24 没有公开 API，并且位于 Cloudflare 托管质询之后，该质询会阻止普通 HTTP（403）。此服务器通过 Playwright 驱动带有持久配置文件的真实 Chrome，因此 Cloudflare 清除 cookie 只需获取一次，并在重启后重复使用。请求以约 3.5 秒的间隔加上抖动进行序列化，以保持礼貌；响应会被缓存（搜索 3 分钟，详情 30 分钟）。

Related MCP server: JobSpy MCP Server

设置

需要 Node >= 20 和 Google Chrome（回退的捆绑 Chromium 需要一次性运行 npx playwright install chromium）。首次运行可能需要约 15-30 秒来通过 Cloudflare 质询。

无需克隆仓库——直接通过 npx 从 npm 运行。

Claude Code

claude mcp add chrono24 -- npx -y chrono24-mcp

或通过 .mcp.json 进行项目级配置：

{
  "mcpServers": {
    "chrono24": {
      "command": "npx",
      "args": ["-y", "chrono24-mcp"]
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "chrono24": {
      "command": "npx",
      "args": ["-y", "chrono24-mcp"]
    }
  }
}

Codex CLI / ChatGPT 桌面版

添加到 ~/.codex/config.toml（由 Codex CLI、IDE 扩展和桌面应用共享）：

[mcp_servers.chrono24]
command = "npx"
args = ["-y", "chrono24-mcp"]
tool_timeout_sec = 120

Cursor

.cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "chrono24": {
      "command": "npx",
      "args": ["-y", "chrono24-mcp"]
    }
  }
}

全局安装替代方案

npm i -g chrono24-mcp
# then use "chrono24-mcp" as the command in any client config

从源码运行

git clone https://github.com/samiashi/chrono24-mcp.git
cd chrono24-mcp
npm install && npm run build && npm run smoke

工具

工具

描述

list_brands

列出所有 550+ 个 Chrono24 手表品牌及其数字 ID（可选名称过滤器）。将 ID 输入 search_listings 的 manufacturerIds，或将名称输入 find_models。

find_models

品牌的型号目录：型号名称、slug 和数字型号 ID（例如 Rolex -> Submariner mod1、Daytona mod2）。与 search_listings 的 models + manufacturerIds 配合使用，进行精确搜索。

list_filters

所有搜索分面过滤器及其允许的值（表壳材质、表带材质、性别、手表类别、国家、列表年龄）。与 search_listings 的 facets 参数一起使用。

search_listings

使用查询 + 过滤器（品牌 ID、型号 ID、参考号、价格范围、状况、年份、卖家国家、分面）进行搜索，排序（relevance、price_asc、price_desc、newest、popularity），分页和可选的 limit（1-60）用于筛选。返回包含 ID、URL、标题、USD 价格、位置、卖家类型、缩略图的卡片。

get_price_stats

手表的价格统计：最小值、p10/p25/中位数/p75/p90、最大值以及来自 60 个最便宜的匹配列表的样本量。一次请求——回答"X 的合理价格是多少？"的快速方法。

get_watch

单个列表 ID 的完整详情：参考号、状况、年份、机芯/口径/动力储备、表壳材质/直径、交付范围、位置、描述、所有照片 URL、规范 URL、卖家 ID。

get_watches

最多 10 个 ID 的批量详情。顺序且礼貌（每个未缓存 ID 约 4 秒）；单个 ID 失败不会中断批量。

get_dealer_listings

经销商当前库存，按 customerId（来自 get_watch 的 sellerIds）。与 search_listings 相同的卡片格式。

get_dealer_ratings

经销商的客户评价，按 dealerId（来自 get_watch 的 sellerIds——一个不同的 ID！）。每条评价的评分、文本、经销商回复、分页总数。

所有价格均归一化为 USD（currencyId=USD）。空结果集是有效结果，而非错误。

环境变量

变量

默认值

用途

REQUEST_DELAY_MS

3500

Chrono24 请求之间的最小间隔。如果看到质询，请提高它。

HEADLESS

true

设置为 false 以运行可见浏览器（当质询需要手动完成一次时很有用）。

CHROME_CHANNEL

true

优先使用已安装的 Google Chrome；设置为 false 以强制使用捆绑的 Chromium。

PROFILE_DIR

~/.cache/chrono24-mcp/profile

保存 Cloudflare 清除 cookie 的浏览器配置文件。

SEARCH_CACHE_TTL_S

180

搜索缓存 TTL。

DETAIL_CACHE_TTL_S

1800

详情缓存 TTL。

TAXONOMY_CACHE_TTL_S

86400

品牌/型号分类缓存 TTL。

MAX_BATCH

10

get_watches 的上限。

CURRENCY_ID

USD

价格归一化货币。

DEBUG

false

向 stderr 输出详细的获取日志。

故障排除

  • Cloudflare 质询超时：等待约 30 秒并重试一次。如果持续出现，使用 HEADLESS=false 运行服务器一次，完成任何交互式质询，然后切换回来。

  • 首次调用缓慢：冷配置文件后的第一个请求会获得清除权限；后续调用会复用它。

  • Chromium 回退缺少浏览器：运行 npx playwright install chromium。

路线图

欢迎提出想法——请提交 issue。

免责声明

教育/研究项目。与 Chrono24 GmbH 无关联、未经其认可，也不存在任何关联。根据司法管辖区和用途，抓取可能违反 Chrono24 的服务条款；您有责任确保合规。速率限制有意保持保守——请保持这种状态。

许可证

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • cryptosense-mcp

    josephibra
    A
    license
    A
    quality
    D
    maintenance
    Real-time crypto market intelligence MCP. Get prices, trending coins, market overview, top coins by market cap, and portfolio value — all through natural language in Claude, Cursor, or any MCP client
    6
    MIT

  • JobSpy MCP Server

    chinpeerapat
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.
    5
    MIT

  • Webotee Amazon Product

    ncosic
    A
    license
    A
    quality
    A
    maintenance
    Hosted Amazon market-intelligence MCP for Claude and ChatGPT: query brands, sellers, ASINs, under-competed niches, the cross-seller operator network, observed buy-box history, and Amazon/Walmart cross-marketplace overlap. 65 read-only research tools over a pre-collected research dataset.
    72
    MIT

  • ebay-mcp

    luke-nielsen
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to search eBay listings, analyze price distributions, find deals, and generate market research overviews via the Model Context Protocol.
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/samiashi/chrono24-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server