carsales-mcp

AIアシスタントがオーストラリア最大の自動車マーケットプレイスである carsales.com.au で中古車・新車を検索できるようにするMCPサーバーです。

Claude Desktop、Claude Code、Cursor、およびMCP互換の任意のクライアント向けに構築されています。

[!NOTE] carsales.com.au は DataDome のボット対策で保護されています。このサーバーは、チャレンジを通過するために実際の Chromium ブラウザ（単純なHTTPクライアントではない）を駆動します。検索結果は確実に動作します。個々のリスティングの詳細ページは、一部のネットワーク/データセンターIPからブロックされる場合があります。その場合、サーバーは検索から既に抽出したリッチなサマリーカードデータ（価格、年式、走行距離、トランスミッション、燃料、ボディ、場所）に自動的にフォールバックします。通常の住宅用接続では、詳細ページは通常正常に読み込まれます。

ツール

search_cars

車を検索します。フィルターは、サポートされている場合は carsales の URL ファセットとして適用され、価格/年式/走行距離はリスティングカードからメモリ内でフィルタリングされます（これらには単純な URL パラメータがありません）。

get_listing_details

listingId（例: OAG-AD-26099426）または完全な url で1件のリスティングの詳細を取得します。詳細ページがボットにブロックされた場合は、サマリーカードデータにフォールバックします。

全体像。 ツールはモデルにリスティングの全体像を提供します:

• get_listing_details / fetch は、価格（乗り出し価格 および 政府諸費用抜き）、価格インジケーター（FAIR/GOOD/GOOD/ GREAT PRICE）、年式、走行距離、トランスミッション、燃料、ボディ、エンジン、販売者+州、機能/仕様の箇条書きリスト、説明、フォトギャラリーを返します。

• includeImages: true（get_listing_details/fetch のデフォルト）を設定すると、実際の写真がダウンロードされ、MCP 画像ブロックとして返されるため、マルチモーダルモデルは文字通り車を見ることができます。search にも includeImages があり（デフォルトはオフ）、各結果のサムネイルを添付します。

• search は、画像が埋め込まれていない場合でも、各結果の image URLをJSONで返します。

セットアップ

1. Playwrightのブラウザをインストール

npm install -g carsales-mcp      # OR clone + npm install
npx playwright install chromium   # downloads the full Chromium build (needed!)

完全なChromiumビルド（channel: 'chromium'）が必要です。ヘッドレスシェルはフィンガープリントされ、DataDomeによってブロックされます。Linuxではシステムライブラリも必要になる場合があります: npx playwright install-deps chromium（またはお使いのディストリビューションの libnss3、libnspr4、libasound2 に相当するもの）。

2. MCPクライアントに追加

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "carsales": {
      "command": "npx",
      "args": ["-y", "carsales-mcp"]
    }
  }
}

Claude Code — ~/.claude/.mcp.json:

{
  "mcpServers": {
    "carsales": {
      "command": "npx",
      "args": ["-y", "carsales-mcp"]
    }
  }
}

3.（オプション）プロキシ / アンチボット調整

carsales.com.au は DataDome の背後にあります。サーバーはこれを乗り切るように構築されています:

Camoufox がデフォルトエンジンです。 Camoufox は Firefox ベースのアンチディテクトブラウザで、Chromium よりもはるかにフィンガープリントされにくいプロファイルを持っています。Camoufox バイナリは初回起動時に自動的にダウンロードされます（npx camoufox-js fetch を実行してくれます。手動の手順は不要です）。Camoufox の起動に失敗した場合、サーバーは透過的に Chromium にフォールバックします。CARS_ENGINE=chromium で Chromium を強制します。

API + スクレイピングのバランス（secondhand-mcp を反映）。 Carapis の API キーをお持ちの場合は、CARAPIS_API_KEY を設定すると、search_cars は carsales.com.au のエンドポイントからクリーンな構造化 JSON を取得します（ボットチャレンジなし）。キーがない場合や呼び出しが失敗した場合は、ブラウザスクレイパーにフォールバックします。これは、secondhand-mcp が eBay と Depad/Poshmark に対して使用するのと同じ、可能な場合は公式API、そうでない場合はスクレイピングという戦略です。

プロキシ。 DataDome は主に IP レピュテーション でブロックするため、（住宅用）プロキシが最も信頼できる修正方法です。CARS_PROXY に単一のプロキシ、またはカンマ区切りのリストを設定すると、リクエストごとにプロキシをローテーションします（以下の再試行ロジックと組み合わせます）:

"env": {
  "CARS_PROXY": "http://user:pass@proxy1:8000,http://user:pass@proxy2:8000",
  "CARAPIS_API_KEY": "your-key"
}

その他の調整用環境変数:

"env": { "CARS_PROXY": "http://127.0.0.1:8899" }

注意事項と制限

• DataDome が時折チャレンジを出すことがあります。検索が何も返さない場合は、再試行してください。

• carsales の利用規約を尊重し、非常に高いページ数で過剰にアクセスしないでください。

• 公式の carsales API は使用されていません。これは実際のブラウザを介して公開サイトをスクレイピングします。

ライセンス

MIT