VIN (Vehicle Identification Number) Query - VIN车辆识别代码查询

---

name: "VIN (Vehicle Identification Number) Query - VIN车辆识别代码查询" description: 用 17 位 VIN 查品牌车型年款等，并可按车型查机油、变速箱等扩展信息。当用户说：这个车架号是什么车？查一下 VIN 对应的排量，或类似 VIN 解析时，使用本技能。 metadata: { "openclaw": { "emoji": "🚗", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }

---

极速数据 VIN 车辆识别代码查询（Jisu VIN）

> 数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

VIN 查询：通过 17 位 VIN 车架号查询车辆品牌、车型、年款、排量、油耗、驱动方式、轮胎规格等；

机油信息：按车型 carid 查询机油参考用量、粘稠度、机油分类、质量等级等（/vin/oil）；

变速箱信息：按车型 carid 查询变速箱型号、品牌、接口型号、加油量及相关图片等（/vin/gearbox）。

前置配置：获取 API Key

1. 前往 极速数据官网 注册账号 2. 进入 VIN 车辆识别代码查询 API 页面，点击「申请数据」 3. 在会员中心获取 AppKey 4. 配置 Key：

# Linux / macOS
export JISU_API_KEY="your_appkey_here"
Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/vin/vin.py

使用方式

1. 按 VIN 车架号查询车辆信息

python3 skills/vin/vin.py '{"vin":"LSVAL41Z882104202"}'

可选开启严格校验：

python3 skills/vin/vin.py '{"vin":"LSVAL41Z882104202","strict":1}'

2. 按车型 ID 查询机油信息（/vin/oil）

carid 一般来自 VIN 查询结果中的 carlist：

python3 skills/vin/vin.py oil 2641

3. 按车型 ID 查询变速箱信息（/vin/gearbox）

python3 skills/vin/vin.py gearbox 21617

VIN 查询请求 JSON 参数

| 字段名 | 类型 | 必填 | 说明 | |--------|--------|------|------------------------------------------------| | vin | string | 是 | 17 位 VIN 车架号 | | strict | int | 否 | 是否严格校验 VIN，0 否、1 是，默认 0 |

示例：

{
  "vin": "LSVAL41Z882104202",
  "strict": 0
}

VIN 查询返回结果示例

脚本直接输出接口 result 字段，结构与官网示例一致（示例简化）：

{
  "name": "大众 途锐 2017款 3.0 TSI 拓野版",
  "brand": "大众",
  "typename": "途锐",
  "logo": "http://pic1.jisuapi.cn/car/static/images/logo/300/34889.jpg",
  "manufacturer": "进口大众",
  "yeartype": "2017",
  "environmentalstandards": "国五",
  "comfuelconsumption": "10.2",
  "fueltype": "汽油",
  "gearbox": "8挡 手自一体",
  "drivemode": "全时四驱",
  "fronttiresize": "255/55 R18",
  "reartiresize": "255/55 R18",
  "displacement": "3.0T",
  "fuelgrade": "95号",
  "price": "71.88万",
  "vin": "WVGAP97P2HD030000",
  "iscorrect": 1,
  "machineoil": {
    "volume": "4.5L",
    "viscosity": "5W-30",
    "grade": "全合成",
    "level": "SN PLUS"
  },
  "carlist": [
    {
      "carid": 40411,
      "name": "大众 途锐 2017款 3.0 TSI 拓界版",
      "typeid": 767,
      "typename": "途锐"
    }
  ]
}

当出现错误（如 VIN 不正确或无数据），脚本会输出：

{
  "error": "api_error",
  "code": 202,
  "message": "VIN不正确"
}

/vin/oil 机油信息

按车型 ID 查询机油信息，调用方式：

python3 skills/vin/vin.py oil 2641

典型返回结构（简化自官网示例）：

{
  "carid": 2641,
  "brandname": "奥迪",
  "parentname": "A4L",
  "name": "2012款 2.0 TFSI(155kW) 运动型",
  "price": "42.38万",
  "yeartype": "2012",
  "listdate": "2011-08-30",
  "productionstate": "停产",
  "salestate": "停销",
  "sizetype": "中型车",
  "machineoil": {
    "volume": "5.0L",
    "viscosity": "5W-40",
    "grade": "全合成",
    "level": "SN"
  }
}

/vin/gearbox 变速箱信息

按车型 ID 查询变速箱信息，调用方式：

python3 skills/vin/vin.py gearbox 21617

典型返回结构（简化自官网示例）：

{
  "carid": 21617,
  "brandname": "凯迪拉克",
  "parentname": "凯迪拉克CT6",
  "name": "2016款 28T 领先版",
  "price": "54.99万",
  "yeartype": "2016",
  "sizetype": "中大型车",
  "gearboxinfo": {
    "gearboxmodel": "8L90",
    "gearboxbrand": "通用",
    "joint": "HS18/HS30",
    "gravityoil": "4L",
    "mechanicaloil": "9-11L",
    "jointpiclist": [
      "http://pic1.jisuapi.cn/car/upload/gearbox/I-HS18.png"
    ],
    "positionpiclist": [
      "http://pic1.jisuapi.cn/car/upload/gearbox/TR-8L451.png"
    ]
  }
}

常见错误码

来源于 极速数据 VIN 文档：

| 代号 | 说明 | |------|------------| | 201 | VIN 为空 | | 202 | VIN 不正确 | | 210 | 没有信息 |

系统错误码：

| 代号 | 说明 | |------|----------------------| | 101 | APPKEY 为空或不存在 | | 102 | APPKEY 已过期 | | 103 | APPKEY 无请求权限 | | 104 | 请求超过次数限制 | | 105 | IP 被禁止 |

推荐用法

1. 用户给出车架号：「帮我查一下 VIN LSVAL41Z882104202 是什么车」。 2. 代理构造 JSON：{"vin":"LSVAL41Z882104202"} 并调用： python3 skills/vin/vin.py '{"vin":"LSVAL41Z882104202"}' 3. 从返回中选取 name/brand/yeartype/displacement/fueltype/drivemode 等字段，给出自然语言总结； 4. 如需机油或变速箱详情，可从 carlist 里选一个 carid 再调用： - 机油：python3 skills/vin/vin.py oil - 变速箱：python3 skills/vin/vin.py gearbox 。

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息

工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测

交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询

图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别

娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令

位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。