Car Deals Search MCP

AIアシスタントでCars.com、Autotrader、KBBの中古車リストを検索

複数のソースから車両リストを集約・検索するMCP (Model Context Protocol) サーバーです。リストを並列してスクレイピングし、価格・走行距離・ディーラー情報を抽出し、オプションのCARFAXスタイルのフィルター（1オーナー、事故歴なし、個人使用）を適用できます。

🚀 クイックスタート

前提条件

• Node.js（v16以上）

• Chrome/Chromium ブラウザがインストールされていること（Puppeteerに必須）

  • Chromeがデフォルトの場所にない場合は、PUPPETEER_EXECUTABLE_PATH 環境変数にChrome/Chromiumのバイナリを指定してください。

インストール

# Clone the repository
git clone https://github.com/SiddarthaKoppaka/car_deals_search_mcp.git
cd car_deals_search_mcp

# Install dependencies (includes Puppeteer)
npm install

MCPクライアントで使用する

このサーバーを使うようにMCPクライアント（Claude Desktop、VS Code、GitHub Copilotなど）を設定します：

Claude Desktopの場合（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "car-deals": {
      "command": "node",
      "args": ["/absolute/path/to/car_deals_search_mcp/src/server.js"]
    }
  }
}

その他のMCPクライアントの場合は、それぞれのドキュメントを参照し、以下のように設定します：

• Command: node

• Args: ["<absolute-path-to-repo>/src/server.js"]

単体テスト

# Run the test command
npm test

# Or test manually with a specific search
node -e "
const { scrapeCarscom } = require('./src/scraper.js');
scrapeCarscom({
  make: 'Toyota',
  model: 'Camry',
  oneOwner: true,
  noAccidents: true,
  personalUse: true
}, 5).then(listings => listings.forEach(l => console.log(l.format())));
"

Related MCP server: StockSpark MCP Server

✨ 機能

• マルチソース集約：Cars.com、Autotrader、KBBを同時に検索

• スマートフィルタリング：CARFAXスタイルのフィルター（1オーナー、事故歴なし、個人使用）

• お買い得評価：ヒューリスティックに基づく取引品質の評価

• 並列スクレイピング：複数ソースへの高速な同時クエリ

• ステルスモード：ボット検出を回避するテクニックを備えたPuppeteer

📊 対応ソース

🔧 MCPツール: search_car_deals

パラメータ

レスポンス例

🚗 2021 Toyota Camry XSE
   💰 Price: $23,491
   📏 Mileage: 52,649 mi
   ⭐ Deal Rating: Good Deal
   🏆 CARFAX: 1-Owner | No Accidents | Personal Use
   🏪 Dealer: Valencia BMW
   🌐 Source: Cars.com
   🔗 https://www.cars.com/vehicledetail/...

🛠️ 技術詳細

• スクレイピング：ボット検出を回避するステルスプラグインを備えたPuppeteer（ヘッドレスChromium）

• 並列処理：複数ソースへの同時クエリのための並列スクレイパーワーカー

• プロトコル：AIアシスタント統合のためのMCP (Model Context Protocol) を実装

• データ抽出：ソース固有のパーサーがリストを共通スキーマに正規化

Chrome/Chromium要件

このプロジェクトはPuppeteerを使用するため、ChromeまたはChromiumのインストールが必要です：

• macOS：Chromeは通常 /Applications/Google Chrome.app/Contents/MacOS/Google Chrome にあります

• Linux：通常はPuppeteerが自動検出するか、/usr/bin/chromium-browser にあります

• Windows：通常 C:\Program Files\Google\Chrome\Application\chrome.exe にあります

Puppeteerがブラウザを見つけられない場合は、環境変数を設定してください：

export PUPPETEER_EXECUTABLE_PATH="/path/to/chrome"

🧪 開発とテスト

# Run tests
npm test

# Test individual scrapers
node src/scraper.js

# View code structure
ls -la src/

🤝 コントリビューション

コントリビューションは歓迎します！以下のワークフローに従ってください：

1. リポジトリをフォークします

2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）

3. 新機能のテストを追加します

4. 変更をコミットします（git commit -m 'Add amazing feature'）

5. ブランチにプッシュします（git push origin feature/amazing-feature）

6. プルリクエストを開きます

スクレイピング/パースの変更には、ソースサイトの更新時にリグレッションが発生しないよう、テストカバレッジを含めてください。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください

🔗 リンク

• リポジトリ: https://github.com/SiddarthaKoppaka/car_deals_search_mcp

• Issues: https://github.com/SiddarthaKoppaka/car_deals_search_mcp/issues

• MCP Protocol: https://modelcontextprotocol.io