Skip to main content
Glama
samiashi
by samiashi

chrono24-mcp

npm CI License: MIT

Инструменты часового маркетплейса Chrono24 для любого LLM-клиента с поддержкой MCP — 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, и сайт находится за управляемым challenge от Cloudflare, который блокирует обычные HTTP-запросы (403). Этот сервер запускает настоящий Chrome через Playwright с постоянным профилем, поэтому cookie допуска Cloudflare получается один раз и переиспользуется между перезапусками. Запросы выполняются последовательно с интервалом ~3.5s и случайным разбросом, чтобы оставаться вежливыми; ответы кэшируются (поиск — 3 минуты, детали — 30 минут).

Related MCP server: JobSpy MCP Server

Установка

Требуются Node >= 20 и Google Chrome (для запасного встроенного Chromium нужно один раз выполнить npx playwright install chromium). Первый запуск может занять ~15-30s на прохождение challenge Cloudflare.

Клонировать репозиторий не нужно — запускайте сразу из npm через npx.

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

Инструменты

Инструмент

Описание

list_brands

Выводит все 550+ брендов часов Chrono24 с числовыми id (необязательный фильтр по названию). Передавайте id в параметр manufacturerIds в search_listings или названия в find_models.

find_models

Каталог моделей бренда: название модели, slug и числовой id модели (например, Rolex -> Submariner mod1, Daytona mod2). Используйте вместе с параметрами models и manufacturerIds в search_listings для точного поиска.

list_filters

Все фасетные фильтры поиска с допустимыми значениями (материал корпуса, материал браслета, пол, категория часов, страна, возраст объявления). Используйте с параметром facets в search_listings.

search_listings

Поиск по запросу и фильтрам (id бренда, id модели, референс, диапазон цен, состояние, год, страны продавцов, facets), сортировка (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. Последовательно и вежливо (~4s на некэшированный id); сбои по отдельным id не прерывают пакет.

get_dealer_listings

Текущий ассортимент дилера по customerId (из sellerIds в get_watch). Тот же формат карточек, что и в search_listings.

get_dealer_ratings

Отзывы покупателей о дилере по dealerId (из sellerIds в get_watch — это другой id!). Оценка и текст каждого отзыва, ответ дилера, итоги пагинации.

Все цены нормализованы к USD (currencyId=USD). Пустые наборы результатов — допустимый исход, а не ошибка.

Переменные окружения

Переменная

По умолчанию

Назначение

REQUEST_DELAY_MS

3500

Минимальный интервал между запросами к Chrono24. Увеличьте его, если когда-нибудь увидите challenge.

HEADLESS

true

Установите false, чтобы запустить видимый браузер (полезно, если challenge нужно один раз пройти вручную).

CHROME_CHANNEL

true

Предпочитать установленный Google Chrome; установите false, чтобы принудительно использовать встроенный Chromium.

PROFILE_DIR

~/.cache/chrono24-mcp/profile

Профиль браузера, в котором хранится cookie допуска Cloudflare.

SEARCH_CACHE_TTL_S

180

Время жизни кэша поиска.

DETAIL_CACHE_TTL_S

1800

Время жизни кэша деталей.

TAXONOMY_CACHE_TTL_S

86400

Время жизни кэша таксономии брендов/моделей.

MAX_BATCH

10

Ограничение для get_watches.

CURRENCY_ID

USD

Валюта нормализации цен.

DEBUG

false

Подробное журналирование загрузок в stderr.

Устранение неполадок

  • Тайм-аут challenge Cloudflare: подождите ~30s и повторите ещё раз. Если проблема не исчезает, запустите сервер один раз с HEADLESS=false, пройдите любой интерактивный challenge и верните настройку обратно.

  • Медленный первый вызов: первый запрос после холодного профиля получает допуск; последующие вызовы переиспользуют его.

  • В запасном Chromium отсутствует браузер: выполните npx playwright install chromium.

Планы развития

Идеи приветствуются — открывайте issue.

Отказ от ответственности

Образовательный/исследовательский проект. Не аффилирован с Chrono24 GmbH, не одобрен ею и не связан с ней. Парсинг может нарушать Условия использования Chrono24 в зависимости от юрисдикции и способа применения; ответственность за соблюдение лежит на вас. Ограничения частоты запросов намеренно консервативны — сохраняйте их такими.

Лицензия

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