Skip to main content
Glama
deenesjakoruzh
samiashi

chrono24-mcp

by samiashi
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

chrono24-mcp

npm CI License: MIT

Herramientas del mercado de relojes de Chrono24 para cualquier cliente LLM compatible con MCP: Claude Code, Claude Desktop, Codex, Cursor, Windsurf y otros.

Busca anuncios, haz una preselección por precio/ubicación/tipo de vendedor y luego obtén los detalles completos del reloj (referencia, movimiento, calibre, caja y papeles, información del concesionario, fotos) sin salir del chat.

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

Cómo funciona

Chrono24 no tiene API pública y está detrás de un desafío gestionado por Cloudflare que bloquea el HTTP simple (403). Este servidor utiliza un Chrome real mediante Playwright con un perfil persistente, de modo que la cookie de autorización de Cloudflare se obtiene una vez y se reutiliza entre reinicios. Las solicitudes se serializan con un espaciado de ~3,5 s más una variación aleatoria para ser respetuosos; las respuestas se almacenan en caché (búsqueda 3 min, detalles 30 min).

Related MCP server: JobSpy MCP Server

Configuración

Requiere Node >= 20 y Google Chrome (el Chromium incluido como respaldo necesita una única ejecución de npx playwright install chromium). La primera ejecución puede tardar ~15-30 s en superar el desafío de Cloudflare.

No es necesario clonar el repositorio: ejecútalo directamente desde npm con npx.

Claude Code

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

o ámbito de proyecto mediante .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 / escritorio de ChatGPT

Añade a ~/.codex/config.toml (compartido por Codex CLI, la extensión del IDE y la aplicación de escritorio):

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

Cursor

.cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

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

Alternativa de instalación global

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

Ejecutar desde el código fuente

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

Herramientas

Tool

Descripción

list_brands

Lista las más de 550 marcas de relojes de Chrono24 con identificadores numéricos (filtro opcional por nombre). Introduce los identificadores en manufacturerIds de search_listings o los nombres en find_models.

find_models

Catálogo de modelos de una marca: nombre del modelo, slug e identificador numérico del modelo (p. ej., Rolex -> Submariner mod1, Daytona mod2). Combínalo con models + manufacturerIds de search_listings para búsquedas precisas.

list_filters

Todos los filtros de faceta de búsqueda con valores permitidos (material de la caja, material de la pulsera, género, categoría de reloj, país, antigüedad del anuncio). Úsalo con el parámetro facets de search_listings.

search_listings

Busca con consulta + filtros (id de marca, id de modelo, referencia, rango de precios, estado, año, países del vendedor, facetas), ordenación (relevance, price_asc, price_desc, newest, popularity), paginación y un limit opcional (1-60) para preseleccionar. Devuelve tarjetas con id, url, título, precio en USD, ubicación, tipo de vendedor y miniatura.

get_price_stats

Estadísticas de precios de un reloj: mínimo, p10/p25/mediana/p75/p90, máximo y tamaño de la muestra de los 60 anuncios coincidentes más baratos. Una sola solicitud: la forma rápida de responder «¿cuál es un precio justo para X?».

get_watch

Detalle completo de un id de anuncio: referencia, estado, año, movimiento/calibre/reserva de marcha, material/diámetro de la caja, alcance de la entrega, ubicación, descripción, todas las URL de fotos, URL canónica e ids de vendedor.

get_watches

Detalle por lotes de hasta 10 ids. Secuencial y respetuoso (~4 s por id no almacenado en caché); los fallos por id no rompen el lote.

get_dealer_listings

Inventario actual de un concesionario por customerId (de sellerIds de get_watch). Misma forma de tarjeta que search_listings.

get_dealer_ratings

Reseñas de clientes de un concesionario por dealerId (de sellerIds de get_watch; ¡un id diferente!). Calificación por reseña, texto, respuesta del concesionario, totales de paginación.

Todos los precios se normalizan a USD (currencyId=USD). Los conjuntos de resultados vacíos son resultados válidos, no errores.

Variables de entorno

Variable

Default

Propósito

REQUEST_DELAY_MS

3500

Espaciado mínimo entre solicitudes a Chrono24. Auméntalo si alguna vez ves desafíos.

HEADLESS

true

Establece false para ejecutar un navegador visible (útil cuando un desafío requiere completarse manualmente una vez).

CHROME_CHANNEL

true

Prefiere Google Chrome instalado; establece false para forzar el Chromium incluido.

PROFILE_DIR

~/.cache/chrono24-mcp/profile

Perfil del navegador que contiene la cookie de autorización de Cloudflare.

SEARCH_CACHE_TTL_S

180

TTL de la caché de búsqueda.

DETAIL_CACHE_TTL_S

1800

TTL de la caché de detalles.

TAXONOMY_CACHE_TTL_S

86400

TTL de la caché de taxonomía de marcas/modelos.

MAX_BATCH

10

Límite para get_watches.

CURRENCY_ID

USD

Moneda de normalización de precios.

DEBUG

false

Registro detallado de las solicitudes en stderr.

Solución de problemas

  • Tiempo de espera del desafío de Cloudflare: espera ~30 s y reintenta una vez. Si persiste, ejecuta el servidor una vez con HEADLESS=false, completa cualquier desafío interactivo y luego vuelve a cambiarlo.

  • Primera llamada lenta: la primera solicitud después de un perfil frío obtiene la autorización; las llamadas posteriores la reutilizan.

  • Falta el navegador de respaldo de Chromium: ejecuta npx playwright install chromium.

Hoja de ruta

Las ideas son bienvenidas: abre un issue.

Aviso legal

Proyecto educativo/de investigación. No está afiliado, respaldado ni asociado con Chrono24 GmbH. El scraping puede violar los Términos de Servicio de Chrono24 según la jurisdicción y el uso; eres responsable del cumplimiento. Los límites de velocidad son deliberadamente conservadores: mantenlos así.

Licencia

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