Skip to main content
Glama
deenesjakoruzh
samiashi

chrono24-mcp

by samiashi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

chrono24-mcp

npm CI License: MIT

Chrono24 ウォッチマーケットプレイスのツールを、MCP対応のLLMクライアント（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.js >= 20 と Google Chrome が必要です（フォールバックのバンドル版 Chromium は、一度 npx playwright install chromium を実行する必要があります）。初回実行時は Cloudflare チャレンジをクリアするのに約 15〜30 秒かかる場合があります。

リポジトリのクローンは不要です。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 desktop

~/.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

ツール

Tool

Description

list_brands

Chrono24 の 550 以上のウォッチブランドを数値 ID とともに一覧表示します（オプションの名前フィルターあり）。ID を search_listings の manufacturerIds に、または名前を find_models に渡します。

find_models

ブランドのモデルカタログ：モデル名、スラッグ、数値モデル 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 件の一致する出品からのサンプルサイズ。1 回のリクエストで「X の適正価格は？」に素早く答える方法です。

get_watch

1 つの出品 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）に正規化されています。空の結果セットは有効な結果であり、エラーではありません。

環境変数

Variable

Default

Purpose

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