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/mcp

• Comprobación de estado: http://127.0.0.1:3100/health

• Punto 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: immo-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 start

El 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 typecheck

Variables de entorno disponibles:

• MCP_HOST: el valor predeterminado es 127.0.0.1

• MCP_PORT: el valor predeterminado es 3100

• MCP_API_TOKEN: token Bearer obligatorio al escuchar fuera de localhost

• MCP_ALLOWED_HOSTS: lista de nombres de host permitidos separados por comas

• LBC_PYTHON_PATH: ruta explícita a un ejecutable de Python con lbc>=1.1.5

• LBC_MAX_PAGES: número máximo de páginas obtenidas por búsqueda; el valor predeterminado es 3

• LBC_PAGE_DELAY_MS: retraso base entre páginas; el valor predeterminado es 1500 ms e incluye jitter aleatorio

• LBC_MAX_RETRIES: reintentos de Datadome dentro del cliente de Python; el valor predeterminado es 1

• LBC_REQUEST_TIMEOUT_SECONDS: tiempo de espera para cada solicitud HTTP de Python; el valor predeterminado es 30

• LBC_WORKER_TIMEOUT_MS: duración máxima de una búsqueda completa del worker; el valor predeterminado es 90000

• LBC_PROXY_URL: URL de proxy opcional, incluidas las credenciales cuando sea necesario

• LBC_IMPERSONATE: perfil de navegador opcional compatible con curl_cffi

• VALUATION_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í sucesivamente

• u_car_model: el ID de la marca, un guion bajo y la etiqueta del modelo sensible a mayúsculas y minúsculas, como RENAULT_Clio, PEUGEOT_208, VOLKSWAGEN_Golf o TESLA_Model 3

• La generación (Clio 3) y el motor (1.5 dCi 90) no forman parte de u_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 1 para gasolina, 2 para diésel, 4 para eléctrico, 6 para híbrido y 8 para híbrido enchufable. Los códigos de caja de cambios son 1 para manual y 2 para 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.