Skip to main content
Glama
samiashi
by samiashi

chrono24-mcp

npm CI License: MIT

MCP를 지원하는 모든 LLM 클라이언트(Claude Code, Claude Desktop, Codex, Cursor, Windsurf 등)를 위한 Chrono24 시계 마켓플레이스 도구입니다.

채팅창을 벗어나지 않고 리스팅을 검색하고, 가격/위치/셀러 유형별로 후보를 추린 다음, 전체 시계 세부 정보(레퍼런스, 무브먼트, 칼리버, 박스 및 서류, 딜러 정보, 사진)를 가져올 수 있습니다.

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가 없으며, 일반 HTTP를 차단하는 Cloudflare 관리형 챌린지 뒤에 있습니다(403). 이 서버는 영구 프로필과 함께 Playwright를 통해 실제 Chrome을 구동하므로, Cloudflare 통과 쿠키를 한 번 획득하면 재시작 후에도 재사용됩니다. 요청은 서버에 부담을 주지 않도록 ~3.5초 간격과 지터(jitter)를 두고 직렬화되며, 응답은 캐시됩니다(검색 3분, 상세 정보 30분).

Related MCP server: JobSpy MCP Server

설정

Node >= 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

도구

도구

설명

list_brands

숫자 ID와 함께 550개 이상의 Chrono24 시계 브랜드를 모두 나열합니다(선택적 이름 필터). ID는 search_listingsmanufacturerIds에, 이름은 find_models에 전달하세요.

find_models

브랜드의 모델 카탈로그: 모델 이름, slug, 숫자 모델 ID(예: Rolex -> Submariner mod1, Daytona mod2). 정확한 검색을 위해 search_listingsmodels + manufacturerIds와 함께 사용하세요.

list_filters

허용 값이 포함된 모든 검색 패싯 필터(케이스 소재, 브레이슬릿 소재, 성별, 시계 카테고리, 국가, 리스팅 경과 시간)를 나열합니다. search_listingsfacets 매개변수와 함께 사용하세요.

search_listings

쿼리 + 필터(브랜드 ID, 모델 ID, 레퍼런스, 가격 범위, 상태, 연도, 셀러 국가, 패싯), 정렬(relevance, price_asc, price_desc, newest, popularity), 페이지네이션, 후보 목록 작성을 위한 선택적 limit(1-60)으로 검색합니다. ID, URL, 제목, USD 가격, 위치, 셀러 유형, 썸네일이 포함된 카드를 반환합니다.

get_price_stats

시계의 가격 통계: 일치하는 가장 저렴한 60개 리스팅에서 최소, p10/p25/median/p75/p90, 최대 및 표본 크기. 요청 한 번으로 "X의 적정 가격은 얼마인가?"에 답하는 빠른 방법입니다.

get_watch

단일 리스팅 ID의 전체 세부 정보: 레퍼런스, 상태, 연도, 무브먼트/칼리버/파워 리저브, 케이스 소재/직경, 배송 구성품, 위치, 설명, 모든 사진 URL, 표준 URL, 셀러 ID.

get_watches

최대 10개 ID의 일괄 상세 정보. 순차적이며 서버에 부담을 주지 않습니다(캐시되지 않은 ID당 ~4초). ID별 실패는 일괄 처리를 중단시키지 않습니다.

get_dealer_listings

customerId를 기준으로 한 딜러의 현재 재고(get_watchsellerIds에서 가져옴). search_listings와 동일한 카드 형식입니다.

get_dealer_ratings

dealerId를 기준으로 한 딜러의 고객 리뷰(get_watchsellerIds에서 가져옴 - 다른 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 통과 쿠키를 보관하는 브라우저 프로필.

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에 상세한 fetch 로깅을 출력합니다.

문제 해결

  • Cloudflare 챌린지 시간 초과: ~30초 기다린 후 한 번 재시도하세요. 계속 발생하면 HEADLESS=false로 서버를 한 번 실행하여 대화형 챌린지를 완료한 후 다시 되돌리세요.

  • 첫 호출이 느림: 콜드 프로필 이후의 첫 번째 요청이 통과 권한을 획득하며, 이후 호출은 이를 재사용합니다.

  • Chromium 대체 브라우저 누락: npx playwright install chromium을 실행하세요.

로드맵

아이디어를 환영합니다. 이슈를 열어주세요.

면책 조항

교육/연구 목적의 프로젝트입니다. 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