CarDeals-MCP

Search used car listings from Cars.com, Autotrader, and KBB with AI assistants

An MCP (Model Context Protocol) server that aggregates and searches car listings from multiple sources. Scrapes listings in parallel, extracts price, mileage, dealer info, and applies optional CARFAX-style filters (1-owner, no accidents, personal use).

- Node.js(v16 or higher)
- Chrome/Chromiumbrowser installed (required by Puppeteer)

- If Chrome is not in the default location, setPUPPETEER_EXECUTABLE_PATHenvironment variable to point to your Chrome/Chromium binary

# 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

Configure your MCP client (Claude Desktop, VS Code, GitHub Copilot, etc.) to use this server:

For Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):

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

For other MCP clients, refer to their documentation and use:

- Command:node
- Args:["<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()))); "

- Multi-source aggregation: Search Cars.com, Autotrader, and KBB simultaneously
- Smart filtering: CARFAX-style filters (1-Owner, No Accidents, Personal Use)
- Deal ratings: Heuristic-based deal quality assessment
- Parallel scraping: Fast concurrent queries across sources
- Stealth mode: Puppeteer with anti-bot detection techniques

🚗 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/...

- Scraping: Puppeteer (headless Chromium) with stealth plugin to bypass bot detection
- Concurrency: Parallel scraper workers for simultaneous multi-source queries
- Protocol: Implements MCP (Model Context Protocol) for AI assistant integration
- Data extraction: Source-specific parsers normalize listings into a common schema

This project uses Puppeteer, which requires Chrome or Chromium to be installed:

- macOS: Chrome is typically at/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
- Linux: Usually auto-detected by Puppeteer or at/usr/bin/chromium-browser
- Windows: Typically atC:\Program Files\Google\Chrome\Application\chrome.exe

If Puppeteer cannot find your browser, set the environment variable:

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

# Run tests npm test # Test individual scrapers node src/scraper.js # View code structure ls -la src/

Contributions are welcome! Please follow this workflow:
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Add tests for new functionality
- Commit your changes (git commit -m 'Add amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

Please include test coverage for scraping/parsing changes to avoid regressions when source sites update.

MIT License - seeLICENSEfile for details

- Repository:https://github.com/SiddarthaKoppaka/car_deals_search_mcp
- Issues:https://github.com/SiddarthaKoppaka/car_deals_search_mcp/issues
- MCP Protocol:https://modelcontextprotocol.io

An MCP server that connects AI agents to Amazon product, search, and review data across 20 marketplaces via the ChocoData Amazon Scraper API.