EnCarAPI - Korean & Chinese used cars

EnCarAPI MCP サーバー：AI アシスタント向けの韓国・中国中古車データ

EnCarAPI 用の Model Context Protocol サーバーです。 Claude、Cursor、ChatGPT などの MCP クライアントで、**韓国の中古車掲載情報（Encar、KB Chachacha、K Car）と中国の中古車掲載情報（Dongchedi、Che168）**をリアルタイムで検索し、詳細情報、検査レポート、事故記録を取得できます。

API キーが必要です。 encarapi.com でキーを取得してください（5 日間のトライアル）。 中国のデータを利用するには、ChinaCarAPI のキー、または China アドオン付きの EnCarAPI キーが必要です。ChinaCarAPI のお客様は、ChinaCarAPI のお客様向けをご覧ください。

ツール

ツール	機能
search_korean_cars	韓国の掲載情報を検索します（ブランド、モデル、年式、価格（10,000 KRW 単位）、走行距離、燃料、事故歴なし、販売者の地域と都市、掲載元：encar / kbc / kcar / all。lang：英語、ロシア語、ドイツ語の値を指定する場合は en、ru、de）
search_korean_excavators	韓国の中古油圧ショベルを検索します（メーカー、モデル、稼働時間、重量クラス、地域。Business/Scale キーが必要）
search_korean_trucks	韓国のトラック、バス、特殊車両を検索します（車体タイプ、積載量（トン）、用途、地域。Business/Scale キーが必要）
find_korean_car_by_vin	1 つの VIN に一致する Encar / K Car の全掲載情報を検索します。削除済みの掲載情報も含みます（Business/Scale キーが必要）
get_korean_truck	1 台のトラックの全レコードを取得します：詳細、検査レポート、荷台、VIN、ナンバープレート（Business/Scale キーが必要）
get_korean_car	1 件の掲載情報の詳細を取得します（仕様、オプション、写真、価格履歴、販売者。lang：en、ru、de）
get_korean_inspection	韓国の公式検査レポートを取得します
get_korean_accident_record	保険事故履歴と所有者の変更履歴を取得します
find_korean_models	ブランド横断でモデル名の入力候補を検索します
korean_filter_values	有効なフィルター値を取得します
search_chinese_cars	中国の掲載情報を検索します（ブランド、モデル、モデル年、登録年、価格（CNY）、走行距離、出力、都市、燃料、掲載元、輸出対応。lang：en、zh、ru）
get_chinese_car	中国の掲載情報 1 件の全レコードを取得します（lang：en、zh、ru）
get_chinese_car_by_url	Che168 / Dongchedi の掲載リンクから全レコードを取得します（デスクトップ版、モバイル版、アプリ版に対応。lang：en、zh、ru）
get_chinese_inspection	中国の検査レポートを取得します（事故、水害、火災、EV バッテリー）
get_chinese_specs	Che168 のグレードの Autohome 仕様書を取得します（cc、kW、hp、トルク、排出ガス基準、重量、EV バッテリー）
chinese_filter_values	有効なメーカー、燃料、都市、掲載元を掲載件数とともに取得します
chinese_models	ブランドのモデルを掲載件数とともに取得します

中国語の lang に zh を指定すると、中国語の値がそのまま返されます。ru を指定すると、固定フィールド（燃料、トランスミッション、駆動方式、色、販売者の種類、車両の状態、車両クラス）、都市名、装備名がロシア語で返されます。メーカー名、モデル名、グレード名はラテン文字のままです。

すべてのツールは読み取り専用です。

オプション 1：ホスト型（インストール不要）

この URL をリモート MCP サーバーとして追加します：

https://mcp.encarapi.com/mcp

OAuth に対応するクライアントでは、URL を追加するだけで利用できます。初回使用時にブラウザーウィンドウが開くので、EnCarAPI キーを一度貼り付けると、クライアントが接続されます：

• Claude（claude.ai、デスクトップ、モバイル）：Settings - Connectors - Add custom connector を選び、URL を貼り付けます
• ChatGPT（開発者モード）：Settings - Connectors で URL を使ってコネクターを作成します
• Cursor：.cursor/mcp.json に {"mcpServers": {"encarapi": {"url": "https://mcp.encarapi.com/mcp"}}} を設定します
• VS Code：「MCP: Add Server」- HTTP を選び、URL を貼り付けます
• Claude Code：

claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp

キーは一度だけ確認され、サーバーには保存されません。クライアントが受け取るトークンに暗号化されます。接続を解除するには、クライアントからサーバーを削除してください。すべてのアクセスを無効にするには、encarapi.com でキーをローテーションしてください。

代替方法：キーを自分で送信する

OAuth に対応していないクライアント、スクリプト、ゲートウェイでは、キーを直接送信できます。

https://mcp.encarapi.com/mcp
Authorization: Bearer YOUR_ENCARAPI_KEY

Claude Code：

claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp \
  --header "Authorization: Bearer YOUR_ENCARAPI_KEY"

x-api-key: YOUR_ENCARAPI_KEY ヘッダーも使用できます。URL のみ受け付け、OAuth に対応していないクライアントでは、https://mcp.encarapi.com/mcp?key=YOUR_ENCARAPI_KEY を使用できます（URL はログに残る可能性があるため、ヘッダーの使用を推奨します）。別途用意した ChinaCarAPI キーは、x-china-key ヘッダー、またはブラウザーのフォームの 2 つ目のフィールドに入力します。

ChinaCarAPI のお客様向け

ChinaCarAPI には専用のアドレスがあります。

https://mcp.chinacarapi.com/mcp

上記と同じ方法で、リモート MCP サーバーとして追加します。初回利用時にブラウザーウィンドウが開くので、ChinaCarAPI キーを一度貼り付けてください。フォームはキーの種類を自動で判別するため、EnCarAPI キーも使用できます。両方のキーをお持ちのお客様は、EnCarAPI キーを任意の 2 つ目のフィールドに入力してください。

• Claude（claude.ai、デスクトップ、モバイル）：Settings - Connectors - Add custom connector を選択し、URL を貼り付けます
• Cursor：.cursor/mcp.json に {"mcpServers": {"chinacarapi": {"url": "https://mcp.chinacarapi.com/mcp"}}} を記述します
• Claude Code：

claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcp

このアドレスでは、中国向けツールが先に表示されます。有効なメーカー、燃料種別、都市を確認するには、まず chinese_filter_values を使用してください（city フィルターには、このリストにある正確な value が必要です）。

ブラウザーでログインせずに使用する場合は、キーをヘッダーで送信してください。mcp.chinacarapi.com では、Authorization: Bearer または x-api-key のキーは ChinaCarAPI キーとして扱われます。

claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcp \
  --header "Authorization: Bearer YOUR_CHINACARAPI_KEY"

x-china-key: YOUR_CHINACARAPI_KEY はどちらのアドレスでも使用できます。その場合、Authorization に EnCarAPI キーを指定すると、韓国向けツールを利用できます。

ローカル（npx）では、ENCARAPI_KEY の代わりに CHINACARAPI_KEY を設定します。

claude mcp add chinacarapi -e CHINACARAPI_KEY=YOUR_CHINACARAPI_KEY -- npx -y encarapi-mcp

オプション 2：ローカル（npx）

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）、その他ほとんどのクライアント：

{
  "mcpServers": {
    "encarapi": {
      "command": "npx",
      "args": ["-y", "encarapi-mcp"],
      "env": {
        "ENCARAPI_KEY": "YOUR_ENCARAPI_KEY"
      }
    }
  }
}

Claude Code：

claude mcp add encarapi -e ENCARAPI_KEY=YOUR_ENCARAPI_KEY -- npx -y encarapi-mcp

任意：別途用意した ChinaCarAPI キーには CHINACARAPI_KEY を設定します。

プロンプトの例

• 「2022 年以降の事故歴なしの Genesis GV80 を 5,000 万 KRW 未満で探し、走行距離を比較してください。」
• 「Encar の掲載情報 41000001 の検査レポートと事故記録を表示してください。」
• 「現在、中国で最も安い輸出可能な BYD Seal の掲載情報を教えてください。」

HTTP エンドポイントのセルフホスト

docker build -t encarapi-mcp .
docker run -p 3000:3000 encarapi-mcp     # POST /mcp, GET /health

ステートレスです。各リクエストにそれぞれのキーが含まれ、何も保存されません。

OAuth フロー（「URL のみで接続」）を有効にするには、2 つの環境変数を設定します。

変数	意味
MCP_OAUTH_SECRET	32 文字以上のランダムな文字列です。例：openssl rand -base64 48。OAuth を有効にします。設定しない場合、サーバーはクライアントから送信されたキーのみを受け付けます。
MCP_PUBLIC_URL	サーバーの公開オリジンです。例：https://mcp.example.com（デフォルトは https://mcp.encarapi.com）。トークンは <MCP_PUBLIC_URL>/mcp に紐付けられます。
MCP_PUBLIC_URLS	任意。カンマ区切りで複数の公開オリジンを指定します。例：https://mcp.encarapi.com,https://mcp.chinacarapi.com。MCP_PUBLIC_URL の代わりに使用されます。Host ヘッダーでオリジンを決定します（不明なホストの場合は最初のオリジンが使用されます）。各オリジンには独自の発行者とブランディングがあり、それぞれのトークンは他のオリジンでは受け付けられません。ホスト名に chinacarapi. を含むオリジンでは、ChinaCarAPI のブランディングが適用されます。

docker run -p 3000:3000 -e MCP_OAUTH_SECRET="$(openssl rand -base64 48)" \
  -e MCP_PUBLIC_URL=https://mcp.example.com encarapi-mcp

これにより、/.well-known/oauth-protected-resource、/.well-known/oauth-authorization-server、/register、/authorize、/token が追加されます（PKCE と動的クライアント登録に対応した OAuth 2.1）。データベースは引き続き使用しません。クライアント ID、認可コード、トークンは、キーを含む自己完結型の暗号化された値（AES-256-GCM）です。これにより、次のような点に注意が必要です。

• MCP_OAUTH_SECRET を変更すると、すべての OAuth クライアントがログアウトされます（ブラウザーで再接続が必要です）。
• アクセストークンの有効期間は 1 時間、リフレッシュトークンの有効期間は 90 日で、使用するたびに置き換えられます。
• 認可コードと置き換えられたリフレッシュトークンの単回使用はメモリー上で追跡されるため、ベストエフォートとなります。再起動後には保持されず、インスタンス間でも共有されません。
• サーバー上で個別のトークンを失効させることはできません。EnCarAPI キーをローテーションすると、すべてのアクセスが遮断されます。

リンク

• EnCarAPI：encarapi.com
• ChinaCarAPI：chinacarapi.com
• SDK：Node.js、Python

EnCarAPI は独立したサービスであり、Encar、KB Chachacha、K Car、 Dongchedi、Che168 とは提携していません。

ライセンス

MIT