MCP Search Auto LBC

비교 가능한 Leboncoin 매물을 기반으로 중고차 시장 가치를 추정하는 MCP 서버입니다. 채택된 각 매물의 제목, 설명, 원시 속성, 이미지, 가격, 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 네트워크 트래픽은 lbc를 기반으로 하는 상주 Python 워커를 거칩니다. 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에서는 .venv\Scripts\python.exe -m pip install -r requirements.txt를 사용하여 Python 종속성을 설치합니다.

명령

npm start
npm run dev
npm test
npm run typecheck

사용 가능한 환경 변수:

• MCP_HOST: 기본값은 127.0.0.1

• MCP_PORT: 기본값은 3100

• MCP_API_TOKEN: localhost 외부에서 수신 대기할 때 필요한 Bearer 토큰

• MCP_ALLOWED_HOSTS: 허용된 호스트 이름의 쉼표로 구분된 목록

• LBC_PYTHON_PATH: lbc>=1.1.5가 포함된 Python 실행 파일의 명시적 경로

• LBC_MAX_PAGES: 검색당 가져오는 최대 페이지 수. 기본값은 3

• LBC_PAGE_DELAY_MS: 페이지 사이의 기본 지연. 기본값은 1500ms이며 무작위 지터를 포함합니다.

• LBC_MAX_RETRIES: Python 클라이언트 내부의 Datadome 재시도 횟수. 기본값은 1

• LBC_REQUEST_TIMEOUT_SECONDS: 각 Python HTTP 요청의 제한 시간. 기본값은 30

• LBC_WORKER_TIMEOUT_MS: 전체 워커 검색의 최대 지속 시간. 기본값은 90000

• LBC_PROXY_URL: 선택적 프록시 URL. 필요한 경우 자격 증명 포함

• LBC_IMPERSONATE: curl_cffi가 지원하는 선택적 브라우저 프로필

• VALUATION_CACHE_TTL_MS: 메모리 내 캐시 수명. 기본값은 15분

도구: resolve_leboncoin_vehicle

이 도구는 자연어 차량 이름을 정확한 Leboncoin 필터 ID로 변환합니다. 먼저 로컬 카탈로그를 확인한 후, 알 수 없는 모델은 한 페이지의 실시간 매물에서 확인할 수 있습니다.

입력 예:

{
  "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의 정확한 필터 ID는 사용자에게 표시되는 라벨과 다릅니다:

• u_car_brand: RENAULT, PEUGEOT, BMW, MERCEDES-BENZ 등

• u_car_model: 브랜드 ID, 밑줄, 대소문자를 구분하는 모델 라벨 (예: 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을 따라야 합니다. 서버는 또한 이 구조를 vehicle://catalog/schema의 MCP 리소스로 게시합니다.

MCP 클라이언트 연결

서버는 Streamable HTTP를 사용합니다. 일반적인 클라이언트 구성은 다음과 같습니다:

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

바로 사용할 수 있는 에이전트 스킬은 skills/leboncoin-vehicle-valuation에서 확인할 수 있습니다.

면책 조항

이 프로젝트는 비공식 API를 사용하며 Leboncoin과 제휴 관계가 없고 Leboncoin의 보증을 받지 않았습니다. 가치 평가는 광고된 요구 가격을 기반으로 한 추정치이며, 보증된 차량 감정이 아닙니다.