MCP Search Auto LBC

Ein MCP-Server, der Gebrauchtwagen-Marktwerte anhand vergleichbarer Leboncoin-Inserate schätzt. Er liefert dem Modell für jedes berücksichtigte Inserat dessen Titel, Beschreibung, Rohattribute, Bilder, Preis und URL sowie die Gründe, warum andere Inserate ausgeschlossen wurden.

Endpunkte

• Lokaler MCP-Endpunkt: http://127.0.0.1:3100/mcp

• Health-Check: http://127.0.0.1:3100/health

• Empfohlener Produktions-Endpunkt: https://mcp.your-domain.com/mcp

Der Server verwendet den MCP Streamable HTTP-Transport. POST /mcp akzeptiert MCP-JSON-RPC-Nachrichten. GET /mcp und DELETE /mcp geben absichtlich HTTP 405 zurück, da der Server ohne Sitzungen arbeitet.

Related MCP server: immo-mcp

Installation

Voraussetzungen: Node.js 20 oder neuer und Python 3.11. Der gesamte Leboncoin-Netzwerkverkehr läuft über einen persistenten Python-Worker, der auf lbc basiert; der TypeScript-Prozess stellt nur MCP bereit und berechnet die Bewertung.

npm install
python3.11 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
npm start

Der Server stellt dann http://127.0.0.1:3100/mcp bereit.

Unter Windows installieren Sie die Python-Abhängigkeiten mit .venv\Scripts\python.exe -m pip install -r requirements.txt.

Befehle

npm start
npm run dev
npm test
npm run typecheck

Verfügbare Umgebungsvariablen:

• MCP_HOST: Standardwert ist 127.0.0.1

• MCP_PORT: Standardwert ist 3100

• MCP_API_TOKEN: erforderliches Bearer-Token, wenn der Server nicht nur auf localhost lauscht

• MCP_ALLOWED_HOSTS: durch Kommas getrennte Liste zulässiger Hostnamen

• LBC_PYTHON_PATH: expliziter Pfad zu einem Python-Executable mit lbc>=1.1.5

• LBC_MAX_PAGES: maximale Anzahl der pro Suche abgerufenen Seiten; Standardwert ist 3

• LBC_PAGE_DELAY_MS: Basisverzögerung zwischen den Seiten; Standardwert ist 1500 ms, inklusive zufälligem Jitter

• LBC_MAX_RETRIES: Datadome-Wiederholungsversuche im Python-Client; Standardwert ist 1

• LBC_REQUEST_TIMEOUT_SECONDS: Timeout für jede Python-HTTP-Anfrage; Standardwert ist 30

• LBC_WORKER_TIMEOUT_MS: maximale Dauer einer vollständigen Worker-Suche; Standardwert ist 90000

• LBC_PROXY_URL: optionale Proxy-URL, einschließlich Zugangsdaten, falls erforderlich

• LBC_IMPERSONATE: optionales Browserprofil, das von curl_cffi unterstützt wird

• VALUATION_CACHE_TTL_MS: Lebensdauer des In-Memory-Caches; Standardwert ist 15 Minuten

Tool: resolve_leboncoin_vehicle

Dieses Tool wandelt natürliche Fahrzeugnamen in exakte Leboncoin-Filter-IDs um. Es prüft zuerst den lokalen Katalog und kann ein unbekanntes Modell anschließend anhand einer Seite mit Live-Inseraten bestätigen.

Beispieleingabe:

{
  "brand": "Renault",
  "model": "Clio III",
  "fuel": "diesel",
  "engine": "1.5 dCi 90"
}

Beispielausgabe:

{
  "resolved": true,
  "brand": "Renault",
  "model": "Clio",
  "leboncoinBrand": "RENAULT",
  "leboncoinModel": "RENAULT_Clio",
  "generation": "3",
  "fuel": "diesel",
  "leboncoinFuel": "2",
  "confidenceScore": 98,
  "source": "catalog",
  "warnings": [],
  "alternatives": []
}

Tool: estimate_used_vehicle

Beispieleingabe:

{
  "brand": "Renault",
  "model": "Clio",
  "leboncoinBrand": "RENAULT",
  "leboncoinModel": "RENAULT_Clio",
  "generation": "3",
  "year": 2010,
  "mileage": 100000,
  "fuel": "diesel",
  "engine": "1.5 dCi 90",
  "gearbox": "manual",
  "trim": "Dynamique",
  "excludeCompanyVehicles": true,
  "excludeProfessionalSellers": true,
  "maxComparables": 20,
  "includeDescriptions": true,
  "includeImages": true
}

Leboncoins exakte Filter-IDs unterscheiden sich von den Beschriftungen, die den Nutzern angezeigt werden:

• u_car_brand: RENAULT, PEUGEOT, BMW, MERCEDES-BENZ usw.

• u_car_model: die Marken-ID, ein Unterstrich und die case-sensitive Modellbezeichnung, z. B. RENAULT_Clio, PEUGEOT_208, VOLKSWAGEN_Golf oder TESLA_Model 3

• Die Generation (Clio 3) und der Motor (1.5 dCi 90) sind nicht Teil von u_car_model; sie werden gegen die Herstellerversion, den Titel, die Attribute und die Beschreibung geprüft.

• Die wichtigsten Kraftstoffcodes sind 1 für Benzin, 2 für Diesel, 4 für Elektro, 6 für Hybrid und 8 für Plug-in-Hybrid. Die Getriebecodes sind 1 für Schaltgetriebe und 2 für Automatik.

Wenn leboncoinBrand oder leboncoinModel weggelassen wird, behält der Server eine Textsuche als Fallback bei.

Beispiel für eine kompakte Ausgabe:

{
  "request": {},
  "valuation": {
    "estimatedPrice": 5000,
    "lowPrice": 4600,
    "highPrice": 5400,
    "quickSalePrice": 4500,
    "currency": "EUR",
    "confidence": "high",
    "confidenceScore": 82
  },
  "market": {
    "adsFetched": 25,
    "comparablesUsed": 14,
    "excludedCount": 11
  },
  "comparables": [
    {
      "title": "Renault Clio III 1.5 dCi 90",
      "price": 5100,
      "description": "Full listing description...",
      "characteristics": {
        "regdate": "2010",
        "mileage": "103000",
        "fuel": "Diesel"
      },
      "images": ["https://..."],
      "url": "https://www.leboncoin.fr/...",
      "similarityScore": 0.92,
      "matchedCriteria": ["brand", "model", "year", "mileage", "fuel", "engine"]
    }
  ],
  "excludedAds": [
    {
      "title": "Damaged Clio sold for parts",
      "reasons": ["damaged, non-running, or parts-only vehicle"]
    }
  ],
  "warnings": []
}

Zukünftige Katalogdaten sollten catalog.example.json folgen. Der Server veröffentlicht diese Struktur außerdem als MCP-Ressource unter vehicle://catalog/schema.

Verbinden eines MCP-Clients

Der Server verwendet Streamable HTTP. Eine typische Client-Konfiguration sieht wie folgt aus:

{
  "mcpServers": {
    "mcp-search-auto-lbc": {
      "url": "http://127.0.0.1:3100/mcp"
    }
  }
}

Der einsatzbereite Agent-Skill ist unter skills/leboncoin-vehicle-valuation verfügbar.

Haftungsausschluss

Dieses Projekt verwendet eine inoffizielle API und ist weder mit Leboncoin verbunden noch von Leboncoin unterstützt. Eine Bewertung ist eine Schätzung auf der Grundlage der in Inseraten angegebenen Verkaufspreise und kein garantiertes Wertgutachten für ein Fahrzeug.