Car Deals Search MCP

Durchsuchen Sie Gebrauchtwagen-Angebote von Cars.com, Autotrader und KBB mit KI-Assistenten

Ein MCP-Server (Model Context Protocol), der Autsuchangebote aus mehreren Browsern aggregiert und durchsucht. Er ruft Angebote parallel ab, extrahiert Preis, Laufleistung, Händlerinformationen und wendet optionale Filter im CARFAX-Stil an (1. Hand, Unfallfrei, Privatnutzung).

🚀 Schnellstart

Voraussetzungen

• Node.js (v16 oder höher)

• Chrome/Chromium-Browser installiert (von Puppeteer benötigt)

  • Wenn sich Chrome nicht am Standardort befindet, setzen Sie die Umgebungsvariable PUPPETEER_EXECUTABLE_PATH, sodass sie auf Ihre Chrome/Chromium-Binärdatei verweist.

Installation

# 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

Verwendung mit MCP-Clients

Konfigurieren Sie Ihren MCP-Client (Claude Desktop, VS Code, GitHub Copilot usw.), um diesen Server zu verwenden:

Für Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

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

Für andere MCP-Clients beachten Sie bitte deren Dokumentation und verwenden Sie:

• Befehl: node

• Argumente: ["<absolute-path-to-repo>/src/server.js"]

Eigenständiges Testen

# 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

✨ Funktionen

• Multi-Quellen-Aggregation: Durchsuchen Sie Cars.com, Autotrader und KBB gleichzeitig

• Intelligente Filterung: Filter im CARFAX-Stil (1. Hand, Unfallfrei, Privatnutzung)

• Deal-Bewertungen: Heuristische Bewertung der Angebotsqualität

• Paralleles Scraping: Schnelle, gleichzeitige Abfragen über mehrere Quellen

• Stealth-Modus: Puppeteer mit Anti-Bot-Erkennungstechniken

📊 Unterstützte Quellen

🔧 MCP-Tool: search_car_deals

Parameter

Beispielantwort

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

🛠️ Technische Details

• Scraping: Puppeteer (Headless Chromium) mit Stealth-Plugin zur Umgehung der Bot-Erkennung

• Parallelität: Parallele Scraper-Worker für gleichzeitige Abfragen mehrerer Quellen

• Protokoll: Implementiert MCP (Model Context Protocol) für die Integration von KI-Assistenten

• Datenextraktion**: Quellenspezifische Parser normalisieren Angebote in ein gemeinsames Schema

Chrome/Chromium-Anforderung

Dieses Projekt verwendet Puppeteer, wofür Chrome oder Chromium installiert sein muss:

• macOS: Chrome befindet sich normalerweise unter /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

• Linux: Wird normalerweise automatisch von Puppeteer erkannt oder befindet sich unter /usr/bin/chromium-browser

• Windows: Normalerweise unter C:\Program Files\Google\Chrome\Application\chrome.exe

Falls Puppeteer den Browser nicht findet, setzen Sie die Umgebungsvariable:

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

🧪 Entwicklung & Tests

# Run tests
npm test

# Test individual scrapers
node src/scraper.js

# View code structure
ls -la src/

🤝 Mitwirken

Beiträge sind willkommen! Bitte gehen Sie wie folgt vor:

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/amazing-feature)

3. Fügen Sie Tests für neue Funktionen hinzu

4. Committen Sie Ihre Änderungen (git commit -m 'Add amazing feature')

5. Pushen Sie den Branch (git push origin feature/amazing-feature)

6. Öffnen Sie einen Pull-Request

Bitte fügen Sie Testabdeckung für Änderungen am Scraping/Parsing hinzu, um Regressionen zu vermeiden.

📄 Lizenz

MIT-Lizenz – siehe die Datei LICENSE füt Depot.

🔗 Links

• Repository: https://github.com/SiddarthaKoppaka/car_deals_search_mcp

• Probleme: https://github.com/SiddarthaKoppaka/car_deals_suche_mcp/issues

• MCP-Protokoll: https://modelcontextprotocol.io