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 では、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: localhost 以外でリッスンする場合に必要な Bearer トークン

• MCP_ALLOWED_HOSTS: 許可するホスト名のカンマ区切りリスト

• LBC_PYTHON_PATH: lbc>=1.1.5 を備えた Python 実行ファイルへの明示的なパス

• LBC_MAX_PAGES: 検索ごとに取得する最大ページ数。デフォルトは 3

• LBC_PAGE_DELAY_MS: ページ間の基本遅延。デフォルトは 1500 ms で、ランダムなジッターを含みます

• 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 に変換します。まずローカルカタログを確認し、その後、ライブ掲載情報の 1 ページから不明なモデルを確認できます。

入力例:

{
  "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 に従う必要があります。サーバーはこの構造を 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 とは提携しておらず、Leboncoin による承認も受けていません。評価額は掲載されている希望価格に基づく推定値であり、車両の保証付き査定額ではありません。