mcp-search-auto-lbc
MCP Search Auto LBC
Un servidor MCP que estima el valor de mercado de coches usados a partir de anuncios comparables de Leboncoin. Proporciona al modelo el título, la descripción, los atributos sin procesar, las imágenes, el precio y la URL de cada anuncio conservado, junto con los motivos por los que se excluyeron otros anuncios.
Puntos de conexión
Punto de conexión MCP local:
http://127.0.0.1:3100/mcpComprobación de estado:
http://127.0.0.1:3100/healthPunto de conexión de producción sugerido:
https://mcp.your-domain.com/mcp
El servidor utiliza el transporte MCP Streamable HTTP. POST /mcp acepta mensajes MCP JSON-RPC. GET /mcp y DELETE /mcp devuelven intencionadamente HTTP 405 porque el servidor funciona sin sesiones.
Related MCP server: fbmarket-mcp
Instalación
Requisitos: Node.js 20 o superior y Python 3.11. Todo el tráfico de red de Leboncoin pasa por un worker de Python persistente respaldado por lbc; el proceso de TypeScript solo expone MCP y calcula la valoración.
npm install
python3.11 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
npm startEl servidor expone entonces http://127.0.0.1:3100/mcp.
En Windows, instala las dependencias de Python con .venv\Scripts\python.exe -m pip install -r requirements.txt.
Comandos
npm start
npm run dev
npm test
npm run typecheckVariables de entorno disponibles:
MCP_HOST: el valor predeterminado es127.0.0.1MCP_PORT: el valor predeterminado es3100MCP_API_TOKEN: token Bearer obligatorio al escuchar fuera de localhostMCP_ALLOWED_HOSTS: lista de nombres de host permitidos separados por comasLBC_PYTHON_PATH: ruta explícita a un ejecutable de Python conlbc>=1.1.5LBC_MAX_PAGES: número máximo de páginas obtenidas por búsqueda; el valor predeterminado es3LBC_PAGE_DELAY_MS: retraso base entre páginas; el valor predeterminado es1500ms e incluye jitter aleatorioLBC_MAX_RETRIES: reintentos de Datadome dentro del cliente de Python; el valor predeterminado es1LBC_REQUEST_TIMEOUT_SECONDS: tiempo de espera para cada solicitud HTTP de Python; el valor predeterminado es30LBC_WORKER_TIMEOUT_MS: duración máxima de una búsqueda completa del worker; el valor predeterminado es90000LBC_PROXY_URL: URL de proxy opcional, incluidas las credenciales cuando sea necesarioLBC_IMPERSONATE: perfil de navegador opcional compatible concurl_cffiVALUATION_CACHE_TTL_MS: tiempo de vida de la caché en memoria; el valor predeterminado es 15 minutos
Herramienta: resolve_leboncoin_vehicle
Esta herramienta convierte nombres de vehículos en lenguaje natural en identificadores exactos de filtros de Leboncoin. Primero consulta el catálogo local y después puede confirmar un modelo desconocido a partir de una página de anuncios activos.
Ejemplo de entrada:
{
"brand": "Renault",
"model": "Clio III",
"fuel": "diesel",
"engine": "1.5 dCi 90"
}Ejemplo de salida:
{
"resolved": true,
"brand": "Renault",
"model": "Clio",
"leboncoinBrand": "RENAULT",
"leboncoinModel": "RENAULT_Clio",
"generation": "3",
"fuel": "diesel",
"leboncoinFuel": "2",
"confidenceScore": 98,
"source": "catalog",
"warnings": [],
"alternatives": []
}Herramienta: estimate_used_vehicle
Ejemplo de entrada:
{
"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
}Los identificadores exactos de los filtros de Leboncoin son diferentes de las etiquetas mostradas a los usuarios:
u_car_brand:RENAULT,PEUGEOT,BMW,MERCEDES-BENZ, y así sucesivamenteu_car_model: el ID de la marca, un guion bajo y la etiqueta del modelo sensible a mayúsculas y minúsculas, comoRENAULT_Clio,PEUGEOT_208,VOLKSWAGEN_GolfoTESLA_Model 3La generación (
Clio 3) y el motor (1.5 dCi 90) no forman parte deu_car_model; se comparan con la versión del fabricante, el título, los atributos y la descripción.Los códigos principales de combustible son
1para gasolina,2para diésel,4para eléctrico,6para híbrido y8para híbrido enchufable. Los códigos de caja de cambios son1para manual y2para automática.
Cuando se omite leboncoinBrand o leboncoinModel, el servidor conserva una búsqueda de texto como respaldo.
Ejemplo de salida condensada:
{
"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": []
}Los datos futuros del catálogo deberían seguir catalog.example.json. El servidor también publica esta estructura como un recurso MCP en vehicle://catalog/schema.
Conexión de un cliente MCP
El servidor utiliza Streamable HTTP. Una configuración típica de cliente tiene este aspecto:
{
"mcpServers": {
"mcp-search-auto-lbc": {
"url": "http://127.0.0.1:3100/mcp"
}
}
}La habilidad de agente lista para usar está disponible en skills/leboncoin-vehicle-valuation.
Descargo de responsabilidad
Este proyecto utiliza una API no oficial y no está afiliado ni respaldado por Leboncoin. Una valoración es una estimación basada en los precios de venta anunciados, no una tasación garantizada del vehículo.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Mechanic-grade used-car listing verdicts: risk score, failure points, repair costs, fair price.
French used-car search across LeBonCoin, LaCentrale, L'Argus and more, with price estimates.
Car-listing search and used-car market analysis as agent tools.
Check supplied vehicle listings for completeness and presentation, with a score and concrete fixes.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables turning photos and observed facts into a ready-to-publish Leboncoin ad, with comparable search, asking-price statistics, category lookup, local drafts, and browser form automation that stops one click short of publishing until approved.23MIT
- AlicenseBqualityCmaintenanceEnables Claude to monitor Facebook Marketplace car and motorcycle listings, score them against custom criteria, and analyze accumulated listing history to reveal time-on-market, price trends, and sale triggers.9MIT
- AlicenseAqualityCmaintenanceEnables Claude to search Leboncoin classified ads with multi-criteria queries, pagination, CSV/JSON export, ad details, and seller profiles.34MIT
- AlicenseAqualityCmaintenanceEnables searching over 1.8 million live Brazilian used-car and motorcycle listings with FIPE reference prices and market analytics, and provides per-listing tools for valuation, market position, and price distribution.17MIT