carsales-mcp

Ein MCP-Server, der einem KI-Assistenten die Suche auf carsales.com.au — Australiens größtem Automarktplatz — nach Gebraucht- und Neuwagen ermöglicht.

Entwickelt für Claude Desktop, Claude Code, Cursor und jeden MCP-kompatiblen Client.

[!HINWEIS] carsales.com.au ist durch den DataDome-Bot-Schutz geschützt. Dieser Server steuert einen echten Chromium-Browser (keinen einfachen HTTP-Client), um die Herausforderung zu bestehen. Die Suchergebnisse funktionieren zuverlässig. Die vollständige Detailseite eines Inserats kann von manchen Netzwerken / Rechenzentrums-IPs blockiert werden — in diesem Fall greift der Server nahtlos auf die bereits aus der Suche extrahierten umfangreichen Zusammenfassungsdaten zurück (Preis, Baujahr, Kilometerstand, Getriebe, Kraftstoff, Karosserie, Standort). Bei einer normalen Heimverbindung lädt die Detailseite normalerweise problemlos.

Werkzeuge

search_cars

Suche nach Autos. Filter werden als carsales-URL-Facetten angewendet, wo unterstützt, und Preis / Baujahr / Kilometerstand werden im Speicher aus den Inseratskarten gefiltert (diese haben keinen einfachen URL-Parameter).

get_listing_details

Ruft vollständige Details für ein Inserat anhand der listingId (z. B. OAG-AD-26099426) oder der vollständigen url ab. Fällt auf die Zusammenfassungsdaten der Karte zurück, wenn die Detailseite vom Bot-Schutz blockiert wird.

Ganzheitliche Sicht. Die Werkzeuge liefern dem Modell das vollständige Bild des Inserats:

• get_listing_details / fetch geben den Preis (Drive-away und ohne staatliche Gebühren), die Preis- einstufung (FAIR/GOOD/GOOD/ GREAT PRICE), Baujahr, Kilometerstand, Getriebe, Kraftstoff, Karosserie, Motor, Verkäufer + Bundesstaat, die Feature-/Ausstattungsliste, die Beschreibung und die Fotogalerie zurück.

• Setze includeImages: true (Standard bei get_listing_details/fetch) und die tatsächlichen Fotos werden heruntergeladen und als MCP-Bildblöcke zurückgegeben, sodass ein multimodales Modell das Auto buchstäblich sehen kann. search hat ebenfalls includeImages (standardmäßig deaktiviert), um jedem Ergebnis das Vorschaubild anzuhängen.

• search gibt die image-URL jedes Ergebnisses in seinem JSON zurück, auch wenn keine Bilder eingebettet sind.

Einrichtung

1. Playwright-Browser installieren

npm install -g carsales-mcp      # OR clone + npm install
npx playwright install chromium   # downloads the full Chromium build (needed!)

Der vollständige Chromium-Build (channel: 'chromium') ist erforderlich — die Headless-Shell wird erkannt und von DataDome blockiert. Unter Linux benötigst du möglicherweise auch Systembibliotheken: npx playwright install-deps chromium (oder die Äquivalente deiner Distribution für libnss3, libnspr4, libasound2).

2. Zum MCP-Client hinzufügen

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. (Optional) Proxy / Anti-Bot-Einstellungen

carsales.com.au steht hinter DataDome. Der Server ist darauf ausgelegt, dies zu überstehen:

Camoufox ist die Standard-Engine. Camoufox ist ein auf Firefox basierender Anti-Erkennungs-Browser mit einem viel schwerer zu fingerabzudrückenden Profil als Chromium. Die Camoufox-Binärdatei wird beim ersten Start automatisch heruntergeladen (es führt npx camoufox-js fetch für dich aus — kein manueller Schritt), und falls Camoufox nicht starten kann, fällt der Server transparent auf Chromium zurück. Erzwinge Chromium mit CARS_ENGINE=chromium.

API + Scraping-Balance (spiegelt secondhand-mcp). Wenn du einen Carapis-API-Schlüssel hast, setze CARAPIS_API_KEY und search_cars wird sauberes strukturiertes JSON von ihrem carsales.com.au-Endpunkt abrufen (keine Bot-Herausforderungen). Wenn der Schlüssel fehlt oder der Aufruf fehlschlägt, fällt es auf den Browser-Scraper zurück. Dies ist dieselbe offizielle-API-wenn-möglich / Scrape-wenn-nicht-Strategie, die secondhand-mcp für eBay vs. Depad/Poshmark verwendet.

Proxy. DataDome blockiert hauptsächlich über die IP-Reputation, daher ist ein (Residential-)Proxy die zuverlässigste Lösung. Setze CARS_PROXY auf einen einzelnen Proxy oder eine kommagetrennte Liste, um bei jeder Anfrage zwischen Proxys zu wechseln (kombiniert mit der untenstehenden Wiederholungslogik):

"env": {
  "CARS_PROXY": "http://user:pass@proxy1:8000,http://user:pass@proxy2:8000",
  "CARAPIS_API_KEY": "your-key"
}

Weitere Umgebungsvariablen zur Feinabstimmung:

"env": { "CARS_PROXY": "http://127.0.0.1:8899" }

Hinweise & Grenzen

• DataDome kann gelegentlich eine Herausforderung stellen; wenn eine Suche nichts zurückgibt, einfach erneut versuchen.

• Respektiere die Nutzungsbedingungen von carsales und vermeide übermäßige Anfragen mit sehr hohen Seitennummern.

• Es wird keine offizielle carsales-API verwendet — dies scraped die öffentliche Website über einen echten Browser.

Lizenz

MIT