Skill: jisuapi/vin (version 1.0.4)

--- 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）](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。 - **VIN 查询**：通过 17 位 VIN 车架号查询车辆品牌、车型、年款、排量、油耗、驱动方式、轮胎规格等； - **机油信息**：按车型 `carid` 查询机油参考用量、粘稠度、机油分类、质量等级等（`/vin/oil`）； - **变速箱信息**：按车型 `carid` 查询变速箱型号、品牌、接口型号、加油量及相关图片等（`/vin/gearbox`）。 ## 前置配置：获取 API Key 1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号 2. 进入 [VIN 车辆识别代码查询 API](https://www.jisuapi.com/api/vin/) 页面，点击「申请数据」 3. 在会员中心获取 **AppKey** 4. 配置 Key： ```bash # Linux / macOS export JISU_API_KEY="your_appkey_here" # Windows PowerShell $env:JISU_API_KEY="your_appkey_here" ``` ## 脚本路径 脚本文件：`skills/vin/vin.py` ## 使用方式 ### 1. 按 VIN 车架号查询车辆信息 ```bash python3 skills/vin/vin.py '{"vin":"LSVAL41Z882104202"}' ``` 可选开启严格校验： ```bash python3 skills/vin/vin.py '{"vin":"LSVAL41Z882104202","strict":1}' ``` ### 2. 按车型 ID 查询机油信息（/vin/oil） `carid` 一般来自 VIN 查询结果中的 `carlist`： ```bash python3 skills/vin/vin.py oil 2641 ``` ### 3. 按车型 ID 查询变速箱信息（/vin/gearbox） ```bash python3 skills/vin/vin.py gearbox 21617 ``` ## VIN 查询请求 JSON 参数 | 字段名 | 类型 | 必填 | 说明 | |--------|--------|------|------------------------------------------------| | vin | string | 是 | 17 位 VIN 车架号 | | strict | int | 否 | 是否严格校验 VIN，0 否、1 是，默认 0 | 示例： ```json { "vin": "LSVAL41Z882104202", "strict": 0 } ``` ## VIN 查询返回结果示例 脚本直接输出接口 `result` 字段，结构与官网示例一致（示例简化）： ```json { "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 不正确或无数据），脚本会输出： ```json { "error": "api_error", "code": 202, "message": "VIN不正确" } ``` ## /vin/oil 机油信息 按车型 ID 查询机油信息，调用方式： ```bash python3 skills/vin/vin.py oil 2641 ``` 典型返回结构（简化自官网示例）： ```json { "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 查询变速箱信息，调用方式： ```bash python3 skills/vin/vin.py gearbox 21617 ``` 典型返回结构（简化自官网示例）： ```json { "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 文档](https://www.jisuapi.com/api/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. 从返回中选取 [REDACTED_SECRET] 等字段，给出自然语言总结； 4. 如需机油或变速箱详情，可从 `carlist` 里选一个 `carid` 再调用： - 机油：`python3 skills/vin/vin.py oil <carid>` - 变速箱：`python3 skills/vin/vin.py gearbox <carid>`。 ## 关于极速数据 **极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API： - **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 - **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 - **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 - **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 - **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 - **位置服务**：基站查询，经纬度地址转换，坐标系转换 在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)