Skip to main content
Glama
mcp-search-auto-lbc

mcp-search-auto-lbc

by npalissi

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: 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 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      23
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      9
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to search Leboncoin classified ads with multi-criteria queries, pagination, CSV/JSON export, ad details, and seller profiles.
      3
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      17
      MIT