{"skill":{"slug":"vinrecognition","displayName":"VIN Recognition OCR - VIN识别","summary":"对车架号/VIN 图片做识别并返回 VIN 及品牌厂家等信息。当用户说：拍了一张车架号照片帮我识别、从图里读出 VIN，或类似 VIN 图片识别时，使用本技能。","description":"---\r\nname: \"VIN Recognition OCR - VIN识别\"\r\ndescription: 对车架号/VIN 图片做识别并返回 VIN 及品牌厂家等信息。当用户说：拍了一张车架号照片帮我识别、从图里读出 VIN，或类似 VIN 图片识别时，使用本技能。\r\nmetadata: { \"openclaw\": { \"emoji\": \"🚗\", \"requires\": { \"bins\": [\"python3\"], \"env\": [\"JISU_API_KEY\"] }, \"primaryEnv\": \"JISU_API_KEY\" } }\r\n---\r\n\r\n## 极速数据 VIN 识别（Jisu VINRecognition）\r\n\r\n> 数据由 **[极速数据（JisuAPI）](https://www.jisuapi.com/)** 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r\n\r\n- 对车辆挡风玻璃处或行驶证上的车架号照片进行 OCR 识别；\r\n- 返回车架号 VIN、是否正确标记、品牌、厂家名称等信息。\r\n\r\n适合用于车辆验真、档案录入、二手车评估等场景。\r\n\r\n## 前置配置：获取 API Key\r\n\r\n1. 前往 [极速数据官网](https://www.jisuapi.com/) 注册账号\r\n2. 进入 [VIN 识别 API](https://www.jisuapi.com/api/vinrecognition/) 页面，点击「申请数据」\r\n3. 在会员中心获取 **AppKey**\r\n4. 配置 Key：\r\n\r\n\r\n```bash\r\n# Linux / macOS\r\nexport JISU_API_KEY=\"your_appkey_here\"\r\n\r\n# Windows PowerShell\r\n$env:JISU_API_KEY=\"your_appkey_here\"\r\n```\r\n\r\n## 脚本路径\r\n\r\n脚本文件：`skills/vinrecognition/vinrecognition.py`\r\n\r\n## 使用方式\r\n\r\n当前脚本通过调用 `/vinrecognition/recognize` 接口，对单张图片进行 VIN 识别。\r\n\r\n### 1. 从本地图片识别 VIN\r\n\r\n```bash\r\npython3 skills/vinrecognition/vinrecognition.py '{\"path\":\"vin.jpg\"}'\r\n```\r\n\r\n### 2. 直接传 base64 图片内容\r\n\r\n```bash\r\npython3 skills/vinrecognition/vinrecognition.py '{\r\n  \"pic\": \"<base64-encoded-image>\"\r\n}'\r\n```\r\n\r\n> 提示：`pic` 字段是图片二进制内容的 base64 编码（不带 `data:image/...;base64,` 前缀），  \r\n> 也可以使用 `image` / `file` 字段传本地路径，脚本会自动读取并转为 base64。\r\n\r\n## 请求参数\r\n\r\nJSON 请求体字段说明：\r\n\r\n| 字段名 | 类型   | 必填 | 说明 |\r\n|--------|--------|------|------|\r\n| pic    | string | 否   | 图片 base64 内容（与 `path/image/file` 至少二选一） |\r\n| path   | string | 否   | 本地图片路径 |\r\n| image  | string | 否   | 本地图片路径（同 `path`） |\r\n| file   | string | 否   | 本地图片路径（同 `path`） |\r\n\r\n当未提供 `pic` 时，脚本会优先从 `path`/`image`/`file` 中读取本地图片并进行 base64 编码。\r\n\r\n## 返回字段\r\n\r\n成功时，脚本直接输出接口 `result` 字段，典型结构：\r\n\r\n```json\r\n{\r\n  \"vin\": \"LFV2A21K0G4053021\",\r\n  \"iscorrect\": 1,\r\n  \"brand\": \"大众\",\r\n  \"manufacturer\": \"一汽大众\"\r\n}\r\n```\r\n\r\n字段说明：\r\n\r\n| 字段名       | 类型   | 说明                         |\r\n|--------------|--------|------------------------------|\r\n| vin          | string | 识别出的车架号               |\r\n| iscorrect    | int    | 是否返回正确车架号：1 是，0 否 |\r\n| brand        | string | 品牌                         |\r\n| manufacturer | string | 厂家名称                     |\r\n\r\n当出现错误（如图片为空、格式不对、超过大小限制等）时，脚本会输出统一错误结构：\r\n\r\n```json\r\n{\r\n  \"error\": \"api_error\",\r\n  \"code\": 201,\r\n  \"message\": \"图片为空\"\r\n}\r\n```\r\n\r\n## 常见错误码\r\n\r\n业务错误码（来源于官网文档）：\r\n\r\n| 代号 | 说明               |\r\n|------|--------------------|\r\n| 201  | 图片为空           |\r\n| 202  | 图片格式错误       |\r\n| 203  | 图片大小超过 300K  |\r\n| 204  | 识别失败           |\r\n\r\n系统错误码：\r\n\r\n| 代号 | 说明             |\r\n|------|------------------|\r\n| 101  | APPKEY 为空或不存在 |\r\n| 102  | APPKEY 已过期    |\r\n| 103  | APPKEY 无请求此数据权限 |\r\n| 104  | 请求超过次数限制   |\r\n| 105  | IP 被禁止       |\r\n| 106  | IP 请求超过限制   |\r\n| 107  | 接口维护中       |\r\n| 108  | 接口已停用       |\r\n\r\n## 推荐用法\r\n\r\n1. 用户上传一张挡风玻璃或行驶证照片，提问：「帮我识别下这辆车的 VIN、品牌和厂家」。  \r\n2. 代理将图片保存为临时文件路径（如 `vin.jpg`），调用：  \r\n   `python3 skills/vinrecognition/vinrecognition.py '{\"path\":\"vin.jpg\"}'`  \r\n3. 从返回结果中读取 `vin/iscorrect/brand/manufacturer` 字段，用自然语言总结给用户；如有需要，还可以结合 `vin/query` 接口获取更详细的车辆配置信息。\r\n\r\n## 关于极速数据\r\n\r\n**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r\n\r\n- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r\n- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r\n- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r\n- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r\n- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r\n- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r\n\r\n在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r\n\r\n","topics":["OCR"],"tags":{"latest":"1.0.5"},"stats":{"comments":0,"downloads":760,"installsAllTime":28,"installsCurrent":0,"stars":11,"versions":6},"createdAt":1773400972294,"updatedAt":1778491885889},"latestVersion":{"version":"1.0.5","createdAt":1775210402951,"changelog":"No code changes detected in this version.\n\n- Updated documentation for clarity and detail, especially around API provider introduction and usage instructions\n- Added a new introductory section about 极速数据 (JisuAPI) and the categories of APIs they provide\n- Improved instructions on how to obtain and configure the required API key (AppKey)\n- Enhanced recommended use case descriptions and added context for ideal skill application\n- No changes to the core logic or API interface","license":"MIT-0"},"metadata":{"setup":[{"key":"JISU_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"jisuapi","userId":"s174fh1b14sn7vkvbqwsdn0xtd83gz5h","displayName":"极速数据","image":"https://avatars.githubusercontent.com/u/30516426?v=4"},"moderation":null}