Car Deals Search MCP

使用 AI 助手搜索来自 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（macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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），用于 AI 助手集成

• 数据提取：各来源专属解析器将列表数据标准化为统一模式

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. Fork 该仓库

2. 创建功能分支（git checkout -b feature/amazing-feature）

3. 为新功能添加测试

4. 提交你的改动（git commit -m 'Add amazing feature'）

5. 推送该分支（git push origin feature/amazing-feature）

6. 提交 Pull Request

若修改涉及抓取/解析逻辑，请务必包含测试，避免部分望站升级时出现回归。

📄 许可证

MIT 许可证 – 详情请参见 LICENSE 文件

🔗 链接

• 仓库：https://github.com/SiddarthaKoppaka/car_deals_search_mcp

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

• MCP 文档：https://modelcontextprotocol.io