mcpField
A
auto-dev

auto-dev

github.com/drivly数据与数据库1873 次安装10 周前更新
代码仓库

关于 auto-dev

通过 MCP 工具、命令行、SDK 或直接 API 调用访问 Auto.dev 汽车数据的 skill。它指导 AI Agent 选择可用接口，并处理车辆列表、VIN 数据、召回信息等请求。

主要功能

  1. 01检测可用的访问方式
  2. 02VIN 解码与车辆列表搜索
  3. 03车辆照片与规格查询
  4. 04召回与持有成本数据
  5. 05API 参数和响应指导

适用场景

  1. 01按筛选条件搜索车辆列表
  2. 02解码用户提供的 VIN
  3. 03查询车辆召回信息和规格
  4. 04计算付款金额或持有成本

MCP 相关

检测到 MCP 工具时，该 skill 指导 Agent 使用 Auto.dev 的 `auto_*` 工具，并通过 `auto_docs` 查询陌生参数和响应结构。它也说明了如何通过 `npx @auto.dev/sdk mcp install` 安装。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/drivly/auto-dev-skill --skill auto-dev

安装后在 Claude Code 中输入/auto-dev确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
CODE_OF_CONDUCT.md
CONTRIBUTING.md
.gitignore
business-workflows.md
app-scaffolding.md
README.md
chaining-patterns.md
code-patterns.md
examples.md
error-recovery.md
v2-listings-api.md
glama.json
v1-apis.md
pricing.md
interactive-explorer.md
integration-recipes.md
v2-plate-api.md
v2-vin-apis.md
.github/
FUNDING.yml
.github/ISSUE_TEMPLATE/
feature_request.md
bug_report.md

详细介绍

Auto.dev

通过 MCP 工具、CLI 命令、SDK 方法或直接 API 调用，为 AI Agent 提供汽车数据。

检测你所使用的方式

按以下顺序检查，使用第一个可用的方式：

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（免费计划无需提供银行卡）。

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解码 VINFree
auto_listings按筛选条件搜索车辆信息Free
auto_photos获取车辆照片Free
auto_specs车辆规格Growth
auto_buildOEM 配置数据（每次调用 $0.10）Growth
auto_recalls安全召回信息Growth
auto_payments付款计算Growth
auto_apr利率Growth
auto_tco总拥有成本Growth
auto_open_recalls未处理／未解决的召回信息Scale
auto_plate车牌转 VIN（每次调用 $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 元数据会被剔除 — 你将获取经过清理的车辆数据。使用 --raw 查看完整的 API 响应。

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 都不可用时使用这些 API。

V2（基址：https://api.auto.dev）：Authorization: Bearer {key} 或 ?apiKey={key} V1（基址：https://auto.dev/api）：?apikey={key}（仅支持查询字符串）

端点计划必需参数
GET /listings?filtersFree请参阅 v2-listings-api.md
GET /listings/{vin}Free—
GET /vin/{vin}Free—
GET /photos/{vin}Free—
GET /specs/{vin}Growth—
GET /build/{vin}Growth—（每次调用 $0.10）
GET /recalls/{vin}Growth—
GET /tco/{vin}Growth—
GET /payments/{vin}Growthprice、zip
GET /apr/{vin}Growthyear、make、model、zip、creditScore
GET /openrecalls/{vin}Scale—
GET /plate/{state}/{plate}Scale—（每次调用 $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 上不存在这些参数名称——Agent 经常会臆造它们：

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 时才需要注意。

计划与定价

每次调用的完整费用和升级链接，请参阅 pricing.md。

计划月费包含内容
免费版$0，无需银行卡VIN 解码、车辆列表、照片（每月 1,000 次调用，硬性上限）
Growth$299/mo + 数据费用+ 车辆规格、召回信息、TCO、付款、APR、配置
Scale$599/mo + 数据费用+ 未处理的召回信息、车牌转 VIN、税费

所有计划的每次请求都需支付按调用计费的数据费用。Growth/Scale 没有调用量上限，但仍需支付数据费用。

重要规则

  • 批量操作前，先使用单个项目调用一次端点，以查看实际响应结构。不要猜测字段名称或嵌套结构——先检查实际响应。
  • 包含 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

评论

支持 Markdown