Car Deals Search MCP

Ищите объявления о подержанных автомобилях на Cars.com, Autotrader и KBB с помощью ИИ-ассистентов

Сервер MCP (Model Context Protocol), который агрегирует и выполняет поиск объявлений об автомобилях из нескольких источников. Парсит объявления параллельно, извлекает цену, пробег, информацию о дилере и применяет опциональные фильтры в стиле CARFAX (1 владелец, без аварий, личное использование).

🚀 Быстрый старт

Предварительные требования

• Node.js (v16 или выше)

• Chrome/Chromium браузер должен быть установлен (требуется Puppeteer)

  • Если Chrome не находится в стандартном расположении, задайте переменную окружения PUPPETEER_EXECUTABLE_PATH, указывающую на ваш исполняемый файл Chrome/Chromium

Установка

# Clone the repository
git clone https://github.com/SiddarthaKoppaka/car_deals_search_mcp.git
cd car_deals_search_mcp

# Install dependencies (includes Puppeteer)
npm install

Использование с MCP-клиентами

Настройте ваш MCP-клиент (Claude Desktop, VS Code, GitHub Copilot и т. д.) для работы с этим сервером:

Для Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "car-deals": {
      "command": "node",
      "args": ["/absolute/path/to/car_deals_search_mcp/src/server.js"]
    }
  }
}

Для других MCP-клиентов обратитесь к их документации и используйте:

• Команда: node

• Аргументы: ["<absolute-path-to-repo>/src/server.js"]

Автономное тестирование

# Run the test command
npm test

# Or test manually with a specific search
node -e "
const { scrapeCarscom } = require('./src/scraper.js');
scrapeCarscom({
  make: 'Toyota',
  model: 'Camry',
  oneOwner: true,
  noAccidents: true,
  personalUse: true
}, 5).then(listings => listings.forEach(l => console.log(l.format())));
"

Related MCP server: StockSpark MCP Server

✨ Возможности

• Агрегация из нескольких источников: одновременный поиск по Cars.com, Autotrader и KBB

• Умная фильтрация: фильтры в стиле CARFAX (1 владелец, без аварий, личное использование)

• Оценка предложений: эвристическая оценка качества сделки

• Параллельный скрапинг: быстрые одновременные запросы к нескольким источникам

• Скрытый режим: Puppeteer с техниками обхода обнаружения ботами

📊 Поддерживаемые источники

🔧 MCP-инструмент: search_car_deals

Параметры

Пример ответа

🚗 2021 Toyota Camry XSE
   💰 Price: $23,491
   📏 Mileage: 52,649 mi
   ⭐ Deal Rating: Good Deal
   🏆 CARFAX: 1-Owner | No Accidents | Personal Use
   🏪 Dealer: Valencia BMW
   🌐 Source: Cars.com
   🔗 https://www.cars.com/vehicledetail/...

🛠️ Технические детали

• Скрапинг: Puppeteer (безголовый Chromium) со stealth-плагином для обхода обнаружения ботами

• Параллельность: параллельные задачи скрапинга для одновременных запросов к нескольким источникам

• Протокол: реализует MCP (Model Context Protocol) для интеграции с ИИ-ассистентами

• Извлечение данных: парсеры для каждого источника нормализуют объявления в единую схему

Требования к Chrome/Chromium

Этот проект использует Puppeteer, для которого требуется установленный Chrome или Chromium:

• macOS: Chrome обычно находится в /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

• Linux: обычно определяется Puppeteer автоматически или находится в /usr/bin/chromium-browser

• Windows: обычно находится в C:\Program Files\Google\Chrome\Application\chrome.exe

Если Puppeteer не может найти ваш браузер, задайте переменную окружения:

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

🧪 Разработка и тестирование

# Run tests
npm test

# Test individual scrapers
node src/scraper.js

# View code structure
ls -la src/

🤝 Участие в разработке

Мы приветствуем ваш вклад! Пожалуйста, следуйте этому рабочему процессу:

1. Сделайте форк репозитория

2. Создайте ветку для изменений (git checkout -b feature/amazing-feature)

3. Добавьте тесты для новой функциональности

4. Зафиксируйте изменения (git commit -m 'Add amazing feature')

5. Отправьте изменения в ветку (git push origin feature/amazing-feature)

6. Откройте пул-реквест

Пожалуйста, добавляйте тестовое покрытие для изменений в скрапинге/парсинге, чтобы избежать регрессий при обновлении сайтов-источников.

📄 Лицензия

Лицензия MIT — подробности в файле LICENSE.

🔗 Ссылки

• Репозиторию: https://github.com/SiddannaKoppaka/car_deals_search_mcp

• Issues: https://github.com/SiddarthaKoppaka/car_deals_search_mcp/issues

• Протокол MCP: https://modelcontextprotocol.io