MCP Search Auto LBC

MCP-сервер, который оценивает рыночную стоимость подержанных автомобилей на основе сопоставимых объявлений Leboncoin. Он предоставляет модели заголовок, описание, исходные атрибуты, изображения, цену и URL каждого отобранного объявления, а также причины, по которым другие объявления были исключены.

Конечные точки

• Локальная конечная точка MCP: http://127.0.0.1:3100/mcp

• Проверка работоспособности: http://127.0.0.1:3100/health

• Рекомендуемая конечная точка для продакшена: https://mcp.your-domain.com/mcp

Сервер используе транспорт MCP Streamable HTTP. POST /mcp принимае сообщения MCP JSON-RPC. GET /mcp и DELETE /mcp намеренно возвращают HTTP 405, посколку сервер работает без сессий.

Related MCP server: immo-mcp

Установка

Требования: Node.js 20 или новее и Python 3.11. Весь сетевой трафик Leboncoin проходит через постоянный Python-воркер на основе lbc; TypeScript-процесс только предоставляет MCP и вычисляет оценку.

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

Затем сервер предоставляет конечную точку http://127.0.0.1:3100/mcp.

В Windows установите зависимости Python с помощью .venv\Scripts\python.exe -m pip install -r requirements.txt.

Команды

npm start
npm run dev
npm test
npm run typecheck

Доступные переменные окружения:

• MCP_HOST: по умолчанию 127.0.0.1

• MCP_PORT: по умолчанию 3100

• MCP_API_TOKEN: обяательный Bearer-токен при прослушивании за пределами localhost

• MCP_ALLOWED_HOSTS: разделённый запятыми список разрешённых имён хостов

• LBC_PYTHON_PATH: явный путь к исполняемому файлу Python с lbc>=1.1.5

• LBC_MAX_PAGES: максимальное количество страниц, загружаемых за один поиск; по умолчанию 3

• LBC_PAGE_DELAY_MS: базовая задержка между страницами; по умолчанию 1500 мс и включае случайный джитер

• LBC_MAX_RETRIES: повторные попытки Datadomе внутри Python-клиента; по умолчанию 1

• LBC_REQUEST_TIMEOUT_SECONDS: таймаут для каждогo HTTP-запроса Python; по умолчанию 30

• LBC_WORKER_TIMEOUT_MS: максимальная продолжителность полного поиска воркера; по умолчанию 90000

• LBC_PROXY_URL: необязательный URL прокси, включая учётные данные, есл они требуются

• LBC_IMPERSONATE: необязательный профиль браузера, поддерживаемый curl_cffi

• VALUATION_CACHE_TTL_MS: время жизни кэша в памяти; по умолчанию 15 минут

Инструмент: resolve_leboncoin_vehicle

Этот инструмент преобразует естественные названия автомобилей в точные идентификаторы фильтров Leboncoin. Сначала он проверяет локальный каталог, а затем может подтвердить неизвестную модель по одной странице актуальных объявлений.

Пример ввода:

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

Пример вывода:

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

Инструмент: estimate_used_vehicle

Пример ввода:

{
  "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
}

Точные идентификаторы фильтров Leboncoin отличаются от меток, отображаемых пользователям:

• u_car_brand: RENAULT, PEUGEOT, BMW, MERCEDES-BENZ и так далее

• u_car_model: идентификатор бренда, подчёркивание и метка модели с учётом регистра, например RENAULT_Clio, PEUGEOT_208, VOLKSWAGEN_Golf или TESLA_Model 3

• Поколение (Clio 3) и двигатель (1.5 dCi 90) не входят в u_car_model; они сверяются с версией производителя, заголовком, атрибутами и описанием.

• Основные коды топива: 1 — бензин, 2 — дизель, 4 — электро, 6 — гибрид, 8 — подключаемый гибрид. Коды коробки передач: 1 — механическая, 2 — автоматическая.

Когда leboncoinBrand или leboncoinModel не указаны, сервер сохраняет текстовый поиск в качестве запасного варианта.

Пример сокращённого вывода:

{
  "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": []
}

Будущие данные каталога должны соответствовать catalog.example.json. Сервер также публикуе эту структуру как ресурс MCP по адресу vehicle://catalog/schema.

Подключение MCP-клиента

Сервер используе Streamable HTTP. Типичная конфигурация клиента выгляди так:

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

Готовый к использованию навык агента доступен в skills/leboncoin-vehicle-valuation.

Отказ от ответственности

Этот проект использует неофициальный API и не аффилирован с Leboncoin и не одобрен им. Оценка стоимости — это приблизительный расчёт на основе цен, запрашиваемых продавцами в объявлениях, а не гарантированная экспертная оценка автомобиля.