carsales-mcp

AI 어시스턴트가 호주 최대 자동차 마켓플레이스인 carsales.com.au에서 중고차와 신차를 검색할 수 있게 해주는 MCP 서버입니다.

Claude Desktop, Claude Code, Cursor 및 MCP 호환 클라이언트를 위해 제작되었습니다.

[!NOTE] carsales.com.au는 DataDome 봇 보호 기능으로 보호됩니다. 이 서버는 일반 HTTP 클라이언트가 아닌 실제 Chromium 브라우저를 구동하여 챌린지를 통과합니다. 검색 결과는 안정적으로 작동합니다. 일부 네트워크/데이터센터 IP에서는 전체 목록 상세 페이지가 차단될 수 있습니다. 이 경우 서버는 검색에서 이미 추출한 풍부한 요약 카드 데이터(가격, 연식, 주행거리, 변속기, 연료, 차체, 위치)로 원활하게 대체됩니다. 일반 가정용 연결에서는 상세 페이지가 보통 정상적으로 로드됩니다.

도구

search_cars

자동차를 검색합니다. 필터는 지원되는 경우 carsales URL 패싯으로 적용되며, 가격/연식/주행거리는 목록 카드에서 메모리 내 필터링됩니다(이들에는 간단한 URL 매개변수가 없음).

get_listing_details

listingId(예: OAG-AD-26099426) 또는 전체 url로 단일 목록의 전체 세부 정보를 가져옵니다. 상세 페이지가 봇에 차단된 경우 요약 카드 데이터로 대체됩니다.

전체적인 관점. 도구는 모델에 전체 목록 정보를 제공합니다:

• get_listing_details / fetch는 가격(도로 비용 포함 및 정부 수수료 제외), 가격 지표(FAIR/GOOD/GOOD/ GREAT PRICE), 연식, 주행거리, 변속기, 연료, 차체, 엔진, 판매자 + 주, 기능/사양 불릿 목록, 설명, 사진 갤러리를 반환합니다.

• includeImages: true(기본값은 get_listing_details/fetch에 대해 true)로 설정하면 실제 사진이 다운로드되어 MCP 이미지 블록으로 반환되므로, 멀티모달 모델이 자동차를 문자 그대로 볼 수 있습니다. search에도 includeImages가 있습니다(기본적으로 꺼짐). 각 결과의 썸네일을 첨부합니다.

• search는 이미지가 포함되지 않은 경우에도 각 결과의 image URL을 JSON으로 반환합니다.

설정

1. Playwright 브라우저 설치

npm install -g carsales-mcp      # OR clone + npm install
npx playwright install chromium   # downloads the full Chromium build (needed!)

전체 Chromium 빌드(channel: 'chromium')가 필요합니다. 헤드리스 셸은 지문이 감지되어 DataDome에 차단됩니다. Linux에서는 시스템 라이브러리도 필요할 수 있습니다: npx playwright install-deps chromium(또는 배포판의 libnss3, libnspr4, libasound2에 해당하는 패키지).

2. MCP 클라이언트에 추가

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code — ~/.claude/.mcp.json:

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

3. (선택 사항) 프록시 / 안티봇 튜닝

carsales.com.au는 DataDome 뒤에 있습니다. 서버는 이를 견디도록 설계되었습니다:

Camoufox가 기본 엔진입니다. Camoufox는 Firefox 기반의 안티탐지 브라우저로, Chromium보다 지문 감지가 훨씬 어렵습니다. Camoufox 바이너리는 첫 실행 시 자동으로 다운로드됩니다(사용자를 위해 npx camoufox-js fetch를 실행하므로 수동 단계가 필요 없음). Camoufox가 시작에 실패하면 서버는 투명하게 Chromium으로 대체됩니다. CARS_ENGINE=chromium으로 Chromium을 강제할 수 있습니다.

API + 스크래핑 균형(secondhand-mcp 미러링). Carapis API 키가 있으면 CARAPIS_API_KEY를 설정하고 search_cars는 carsales.com.au 엔드포인트에서 깔끔한 구조화된 JSON을 가져옵니다(봇 챌린지 없음). 키가 없거나 호출이 실패하면 브라우저 스크래퍼로 대체됩니다. 이는 secondhand-mcp가 eBay 대 Depad/Poshmark에 사용하는 것과 동일한 공식 API 가능 시 / 불가능 시 스크래핑 전략입니다.

프록시. DataDome은 주로 IP 평판으로 차단하므로 (가정용) 프록시가 가장 확실한 해결책입니다. CARS_PROXY를 단일 프록시로 설정하거나, 쉼표로 구분된 목록으로 설정하여 요청마다 프록시를 순환시킬 수 있습니다(아래 재시도 로직과 결합):

"env": {
  "CARS_PROXY": "http://user:pass@proxy1:8000,http://user:pass@proxy2:8000",
  "CARAPIS_API_KEY": "your-key"
}

기타 튜닝 환경 변수:

"env": { "CARS_PROXY": "http://127.0.0.1:8899" }

참고 사항 및 제한 사항

• DataDome이 가끔 챌린지를 발생시킬 수 있습니다. 검색 결과가 없으면 그냥 다시 시도하세요.

• carsales의 서비스 약관을 준수하고 매우 많은 페이지 수로 과도한 요청을 보내지 마세요.

• 공식 carsales API는 사용되지 않습니다. 실제 브라우저를 통해 공개 사이트를 스크래핑합니다.

라이선스

MIT