auto-dev

Auto.dev

AI エージェント向けの自動車データ — MCP ツール、CLI コマンド、SDK メソッド、または直接 API 呼び出しで利用できます。

利用環境の確認

次の順番で確認します。最初に利用できるものを使ってください。

1. MCP — 利用可能なツールに auto_decode があるか確認します。 ある場合は、すべての操作に auto_* ツールを使ってください。生の HTTP 呼び出しは絶対に行わないでください。 インストールするには、npx @auto.dev/sdk mcp install を実行します（グローバルにインストールされ、Claude Code、Claude Desktop、Cursor、Windsurf、VS Code Copilot、Cline、Zed が設定されます）。

2. CLI — auto --version を実行します。 インストール済みの場合は、auto login で一度認証してから（OAuth — API キーは不要です）、auto コマンドを使います。 インストールするには、npm install -g @auto.dev/sdk を実行するか、インストールせずに npx @auto.dev/sdk <command> を使います。

3. SDK — プロジェクトの依存関係に @auto.dev/sdk があるか確認します。 ある場合は、型付き SDK メソッドを使います。すべてのメソッドについては code-patterns.md を参照してください。 インストールするには、npm install @auto.dev/sdk を実行します。

4. 直接 API — AUTODEV_API_KEY 環境変数があるか確認します。 設定されていない場合は、ユーザーにキーを尋ねるか、https://auto.dev/pricing を案内してください（Free プランではカードは不要です）。

MCP ツール

MCP ツールが利用可能な場合は、このセクションだけを使ってください。 見慣れないエンドポイントを呼び出す前に、auto_docs を使って パラメーターとレスポンス形式を確認してください。

auto_docs listings      # see all listing filters
auto_docs payments      # see payment params
auto_docs vin-decode    # see VIN decode response shape

ツール	説明	プラン
auto_decode	VIN をデコードします	Free
auto_listings	フィルターを使って掲載車両を検索します	Free
auto_photos	車両の写真を取得します	Free
auto_specs	車両の仕様を取得します	Growth
auto_build	OEM の製造データ（1 回あたり $0.10）	Growth
auto_recalls	安全性に関するリコール	Growth
auto_payments	支払い額を計算します	Growth
auto_apr	金利	Growth
auto_tco	総保有コスト	Growth
auto_open_recalls	未対応／未解決のリコール	Scale
auto_plate	ナンバープレートから VIN を取得（1 回あたり $0.55）	Scale
auto_taxes	税金と手数料	Scale
auto_docs	同梱された API ドキュメントを検索します	—
auto_config_set	設定値を指定します（例：raw: true）	—
auto_config_get	設定値を取得するか、すべての設定を一覧表示します	—

MCP ツールのレスポンスでは、API メタデータはデフォルトで除外されます。完全なレスポンスを取得するには、auto_config_set で key: "raw"、value: "true" を指定します。

MCP ツールが利用可能な場合は、「重要なルール」までスキップしてください。

CLI クイックリファレンス

インストール：npm install -g @auto.dev/sdk（またはインストールせずに npx @auto.dev/sdk を使用） 一度だけ認証：auto login

auto decode <vin>
auto photos <vin>
auto listings --make Toyota --year 2024 --price 10000-40000 --state CA
auto specs <vin>
auto build <vin>
auto recalls <vin>
auto open-recalls <vin>
auto payments <vin> --price 35000 --zip 90210 --down-payment 5000
auto apr <vin> --year 2024 --make Honda --model Accord --zip 90210 --credit-score 750
auto tco <vin> --zip 90210
auto taxes <vin> --price 35000 --zip 90210
auto plate <state> <plate>
auto usage
auto docs [query]        # search bundled docs
auto explore [endpoint]  # browse params and mappings

すべてのコマンドで --json、--yaml、--raw、--api-key <key> フラグを使用できます。

API メタデータはデフォルトで除外され、車両データのみが取得されます。API の完全なレスポンスを確認するには、--raw を使います。

auto config set raw true    # always show full responses
auto config get raw         # check current value
auto config list            # show all settings

CLI の完全なリファレンス：https://docs.auto.dev/v2/cli-mcp-sdk CLI が利用可能な場合は、「重要なルール」までスキップしてください。

直接 API クイックリファレンス

MCP と CLI が利用できない場合にのみ使用してください。

V2（ベース：https://api.auto.dev）：Authorization: Bearer {key} または ?apiKey={key} V1（ベース：https://auto.dev/api）：?apikey={key}（クエリ文字列のみ）

エンドポイント	プラン	必須パラメーター
GET /listings?filters	Free	v2-listings-api.md を参照
GET /listings/{vin}	Free	—
GET /vin/{vin}	Free	—
GET /photos/{vin}	Free	—
GET /specs/{vin}	Growth	—
GET /build/{vin}	Growth	—（1 回あたり $0.10）
GET /recalls/{vin}	Growth	—
GET /tco/{vin}	Growth	—
GET /payments/{vin}	Growth	price、zip
GET /apr/{vin}	Growth	year、make、model、zip、creditScore
GET /openrecalls/{vin}	Scale	—
GET /plate/{state}/{plate}	Scale	—（1 回あたり $0.55）
GET /taxes/{vin}	Scale	—

V1 の補足エンドポイント（V2 に相当するものはありません）：/api/models、/api/cities、/api/zip/{zip}、/api/autosuggest/{term}

直接 API を呼び出す前に、該当するリファレンスファイルを読み、パラメーター名と使用例を確認してください。 パラメーターの完全なリファレンス：v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md

よくある注意点（すべてのサーフェス）

以下のパラメーター名は Direct API には存在しません。エージェントが頻繁に誤って生成します。

make=    ← use vehicle.make
model=   ← use vehicle.model
state=   ← use retailListing.state
price=   ← use retailListing.price (on /listings), or price= (on /payments, /taxes)
rows=    ← use limit
sort=    ← no sort parameter exists
_order=  ← no sort parameter exists

MCP と CLI はこれらのマッピングを自動的に処理します。これは Direct API の呼び出しにのみ関係します。

プランと料金

1 回あたりの費用の詳細とアップグレードリンクについては、pricing.md をご覧ください。

プラン	月額	含まれるもの
Free	$0、カード不要	VIN のデコード、リスティング、写真（月 1,000 回の呼び出し、上限あり）
Growth	$299/月 + データ料金	+ 仕様、リコール、TCO、支払い、APR、ビルド
Scale	$599/月 + データ料金	+ 未解決のリコール、ナンバープレートから VIN の検索、税金と手数料

すべてのプランで、リクエストごとにデータ料金が発生します。Growth／Scale には利用量の上限はありませんが、データ料金は引き続き適用されます。

重要なルール

• バッチ操作の前に、実際のレスポンス形式を確認するため、単一の項目でエンドポイントを 1 回呼び出してください。フィールド名や入れ子構造を推測せず、まず実際のレスポンスを確認してください。
• ユーザーが一部を除外するよう明示していない限り、API レスポンスのすべてのフィールドを含めてください。
• 結果が少ない場合（10 件未満、単一の VIN）：書式設定した表としてインラインで表示
• 結果が多い場合（リスティング 10 件以上）：ユーザーの希望を尋ね、既定では CSV にエクスポート
• 必ず対応すること：ユーザーからリクエストがあった場合は、CSV と JSON のエクスポートに対応
• クエリが複数のエンドポイントにまたがる場合は API を連携すること — MCP ツールと CLI コマンドは並列で呼び出せます
• 機微な入力：creditScore、zip、および /apr、/payments、/taxes の価格／下取り／頭金フィールドは Auto.dev API に送信されます。これらの値は推測せずユーザーに尋ね、エンドポイントが必要とするものだけを送信し、回答後は保存したり繰り返し表示したりしないでください。
• ナンバープレートの照会（/plate/{state}/{plate}）は、ナンバープレートから特定の車両を特定し、所有者を識別できる場合があります。正当な目的があることを確認し、ユーザーから提供されていないナンバープレートを一括で照会しないでください。
• エクスポートをディスクに書き込む場合は、まず保存先のパスを確認し、尋ねずに既存のファイルを上書きしないでください。

詳細リファレンス

MCP または CLI： ライブのパラメーター検索には auto_docs [query] または auto docs [query] を使用してください。 完全なリファレンス：https://docs.auto.dev/v2/cli-mcp-sdk

SDK： 型付きメソッドとレスポンス形式については、code-patterns.md をご覧ください。

Direct API：

• API ドキュメント：v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md
• ワークフロー：chaining-patterns.md | interactive-explorer.md | business-workflows.md
• コード生成：code-patterns.md | app-scaffolding.md | integration-recipes.md
• その他：error-recovery.md | pricing.md | examples.md