carsales-mcp

Сервер MCP, который позволяет ИИ-ассистенту искать carsales.com.au — крупнейший автомобильный маркетплейс Австралии — подержанные и новые автомобили.

Создан для Claude Desktop, Claude Code, Cursor и любого MCP-совместимого клиента.

[!ПРИМЕЧАНИЕ] carsales.com.au защищён бот-защитой DataDome. Этот сервер использует настоящий браузер Chromium (а не обычный HTTP-клиент), чтобы пройти проверку. Результаты поиска работают надёжно. Полная страница объявления может быть заблокирована для некоторых сетей / IP-адресов дата-центров — в этом случае сервер корректно переключается на богатые данные из карточки сводки, которые он уже извлёк из поиска (цена, год, одометр, трансмиссия, топливо, кузов, местоположение). На обычном домашнем подключении страница объявления обычно загружается нормально.

Инструменты

search_cars

Поиск автомобилей. Фильтры применяются как фасеты URL carsales, где это поддерживается, а цена / год / одометр фильтруются в памяти из карточек объявлений (для них нет простого параметра URL).

get_listing_details

Получение полных деталей для одного объявления по listingId (например, OAG-AD-26099426) или полному url. Если страница объявления заблокирована бот-защитой, используется резервный вариант с данными из карточки сводки.

Целостный взгляд. Инструменты предоставляют модели полную картину объявления:

• get_listing_details / fetch возвращают цену (с учётом выезда и без государственных сборов), индикатор цены (FAIR/GOOD/GOOD/ GREAT PRICE), год, одометр, трансмиссию, топливо, кузов, двигатель, продавца и штат, список характеристик/спецификаций, описание и фотогалерею.

• Установите includeImages: true (по умолчанию для get_listing_details/fetch), и фактические фотографии будут загружены и возвращены как блоки изображений MCP, так что мультимодальная модель сможет буквально видеть автомобиль. search также имеет includeImages (по умолчанию выключен) для прикрепления миниатюры каждого результата.

• search возвращает URL image каждого результата в своём 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') — headless shell имеет отпечаток и блокируется 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. Принудительно используйте Chromium с CARS_ENGINE=chromium.

Баланс API + скрапинг (аналогично secondhand-mcp). Если у вас есть Carapis API-ключ, установите CARAPIS_API_KEY, и search_cars будет получать чистый структурированный JSON из их конечной точки carsales.com.au (без бот-проверок). Если ключ отсутствует или вызов не удаётся, он переключается на браузерный скрапер. Это та же стратегия «официальный API, где возможно / скрапинг, где нет», которую secondhand-mcp использует для eBay против Depad/Poshmark.

Прокси. 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 и избегайте чрезмерной нагрузки с очень большим количеством страниц.

• Официальный API carsales не используется — это скрапинг публичного сайта через настоящий браузер.

Лицензия

MIT