Skip to main content
Glama
samiashi
by samiashi

chrono24-mcp

npm CI License: MIT

Chrono24 Werkzeuge für den Uhrenmarktplatz für jeden MCP-fähigen LLM-Client – Claude Code, Claude Desktop, Codex, Cursor, Windsurf und weitere.

Durchsuche Angebote, filtere nach Preis/Standort/Verkäufertyp und rufe dann vollständige Uhrdetails ab (Referenz, Uhrwerk, Kaliber, Box & Papiere, Händlerinfo, Fotos), ohne deinen Chat zu verlassen.

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

So funktioniert es

Chrono24 hat keine öffentliche API und sitzt hinter einer von Cloudflare verwalteten Challenge, die einfaches HTTP blockiert (403). Dieser Server steuert ein echtes Chrome über Playwright mit einem persistenten Profil, sodass das Cloudflare-Freigabe-Cookie einmal erworben und über Neustarts hinweg wiederverwendet wird. Anfragen werden mit ~3.5s Abstand plus Jitter serialisiert, um höflich zu bleiben; Antworten werden zwischengespeichert (Suche 3 min, Details 30 min).

Related MCP server: JobSpy MCP Server

Setup

Erfordert Node >= 20 und Google Chrome (das als Fallback gebündelte Chromium benötigt einmalig npx playwright install chromium). Der erste Start kann ~15-30s dauern, um die Cloudflare-Challenge zu lösen.

Kein Repository-Klon nötig – direkt mit npx von npm ausführen.

Claude Code

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

oder Projektbereich über .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

Füge zu ~/.codex/config.toml hinzu (wird von Codex CLI, IDE-Erweiterung und Desktop-App gemeinsam genutzt):

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

Cursor

.cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global):

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

Globale Installation als Alternative

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

Aus dem Quellcode ausführen

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

Tools

Tool

Beschreibung

list_brands

Listet alle 550+ Chrono24-Uhrenmarken mit numerischen IDs auf (optionaler Namensfilter). Speise IDs in manufacturerIds von search_listings oder Namen in find_models ein.

find_models

Der Modellkatalog einer Marke: Modellname, Slug und numerische Modell-ID (z. B. Rolex -> Submariner mod1, Daytona mod2). Kombiniere mit models + manufacturerIds von search_listings für präzise Suchen.

list_filters

Alle Such-Facettenfilter mit erlaubten Werten (Gehäusematerial, Armbandmaterial, Geschlecht, Uhrenkategorie, Land, Listungsalter). Verwende mit dem facets-Parameter von search_listings.

search_listings

Suche mit Abfrage + Filtern (Marken-ID, Modell-ID, Referenz, Preisbereich, Zustand, Jahr, Verkäuferländer, Facetten), Sortierung (relevance, price_asc, price_desc, newest, popularity), Seitenwechsel und optionalem limit (1-60) für eine Shortlist. Gibt Karten mit ID, URL, Titel, USD-Preis, Standort, Verkäufertyp, Vorschaubild zurück.

get_price_stats

Preisstatistik für eine Uhr: Min, p10/p25/Median/p75/p90, Max und Stichprobengröße aus den 60 günstigsten passenden Angeboten. Eine Anfrage – der schnelle Weg, um zu beantworten: „Was ist ein fairer Preis für X?“.

get_watch

Vollständige Details für eine Angebots-ID: Referenz, Zustand, Jahr, Uhrwerk/Kaliber/Gangreserve, Gehäusematerial/Durchmesser, Lieferumfang, Standort, Beschreibung, alle Foto-URLs, kanonische URL, Verkäufer-IDs.

get_watches

Batch-Details für bis zu 10 IDs. Sequenziell und höflich (~4s pro ungecachter ID); Fehler pro ID brechen den Batch nicht ab.

get_dealer_listings

Das aktuelle Inventar eines Händlers anhand von customerId (aus sellerIds von get_watch). Gleiche Kartenform wie search_listings.

get_dealer_ratings

Kundenbewertungen eines Händlers anhand von dealerId (aus sellerIds von get_watch – eine andere ID!). Bewertung, Text, Händlerantwort und Gesamtzahlen pro Seite.

Alle Preise werden in USD normalisiert (currencyId=USD). Leere Ergebnismengen sind gültige Ergebnisse, keine Fehler.

Umgebungsvariablen

Variable

Standard

Zweck

REQUEST_DELAY_MS

3500

Mindestabstand zwischen Chrono24-Anfragen. Erhöhe ihn, falls du jemals Challenges siehst.

HEADLESS

true

Setze false, um einen sichtbaren Browser auszuführen (nützlich, wenn eine Challenge einmal manuell abgeschlossen werden muss).

CHROME_CHANNEL

true

Bevorzuge installiertes Google Chrome; setze false, um gebündeltes Chromium zu erzwingen.

PROFILE_DIR

~/.cache/chrono24-mcp/profile

Browserprofil, das das Cloudflare-Freigabe-Cookie enthält.

SEARCH_CACHE_TTL_S

180

TTL für Suchcache.

DETAIL_CACHE_TTL_S

1800

TTL für Detailcache.

TAXONOMY_CACHE_TTL_S

86400

TTL für Marken-/Modell-Taxonomie-Cache.

MAX_BATCH

10

Obergrenze für get_watches.

CURRENCY_ID

USD

Währung für Preisnormalisierung.

DEBUG

false

Detaillierte Fetch-Logs auf stderr.

Fehlerbehebung

  • Cloudflare-Challenge-Timeout: Warte ~30s und versuche es einmal erneut. Falls es anhält, starte den Server einmalig mit HEADLESS=false, löse alle interaktiven Challenges und wechsle dann zurück.

  • Langsamer erster Aufruf: Die erste Anfrage nach einem kalten Profil erwirbt die Freigabe; nachfolgende Aufrufe nutzen sie wieder.

  • Chromium-Fallback ohne Browser: Führe npx playwright install chromium aus.

Roadmap

Ideen willkommen – eröffne ein Issue.

Haftungsausschluss

Bildungs-/Forschungsprojekt. Nicht mit Chrono24 GmbH verbunden, von ihr unterstützt oder assoziiert. Scraping kann je nach Rechtsgebiet und Nutzung gegen die Nutzungsbedingungen von Chrono24 verstoßen; du bist für die Einhaltung verantwortlich. Die Ratenlimits sind bewusst konservativ – behalte sie so bei.

Lizenz

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

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.

Related MCP Servers

  • 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
  • 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
  • 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
  • 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