VIN配件 精准译码

通过 17 位 VIN 车架号 与 待译码的配件别名列表, 精准解出这些配件的 标准配件编码OE 与 标准配件名称等信息

Security Scan

The skill's code, instructions, and required environment variable (JZ_API_KEY) are coherent with its stated purpose: it calls the specified VIN->OE web API and returns parsed results.

Purpose & Capability

Name/description describe VIN+parts-name -> OE decoding. The code calls https://erp.qipeidao.com/jzOpenClaw/getVinOe and requires JZ_API_KEY; python3 is the only binary required. No unrelated credentials or binaries are requested.

Instruction Scope

SKILL.md and the script only instruct constructing a VIN+parts list request and posting it to the documented backend. The instructions do not read unrelated files, system state, or other environment variables; they only use JZ_API_KEY and the command-line args (VIN and parts list).

Install Mechanism

There is no install spec (instruction-only with a shipped script) which minimizes install risk. Minor note: the script uses the Python 'requests' library but the skill does not declare or provide an installation step for that dependency — the runtime must have requests available.

Credentials

Only one env var (JZ_API_KEY) is required and is used to authenticate to the documented API. This is proportional to the stated function; no unrelated secrets or config paths are requested.

Persistence & Privilege

Skill does not request always:true, does not modify other skills or system settings, and does not require persistent agent presence. Autonomous invocation is enabled by default but is normal and not excessive here.

Assessment

This skill sends the VIN, parts names, and your JZ_API_KEY to https://erp.qipeidao.com/jzOpenClaw/getVinOe. Only install if you trust that service and the API key provider. Confirm the API key scope and revoke it if misused. Ensure your runtime has Python 'requests' installed. If you have privacy or compliance concerns about sending VINs to an external service, verify vendor policies or test with non-sensitive VINs first.

积智数据 VIN 精准译码（ VIN+PARTSNAME）

基于 [VIN 精准译码 API] 的 OpenClaw 技能，支持：

• VIN PARTSNAME 精准译码：通过 17 位 VIN 车架号 与 待译码的配件别名列表, 精准解出这些配件的 标准配件编码OE 与 标准配件名称等信息

使用技能前需要申请数据，请联系【积智数据】 MOBILE [phone]) ; EMAIL( [e-mail]/[e-mail]) 获取。

后端服务

本技能依赖 VIN-PARTSNAME 精准译码 服务，接口地址：https://erp.qipeidao.com/jzOpenClaw/getVinOe

环境变量配置

# Linux / macOS
export JZ_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JZ_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/vinoe/get_vin_oe.py

使用方式

1. 根据 VIN + 询价配件别名列表 精准解析出 询价配件的标准配件编码 与 标准配件名称 信息

python3 skills/vinoe/get_vin_oe.py {"vinCode":"LSVAL41Z882104202","partsNameList":["前保险杠皮","中网"]}

##VIN 精准译码 请求参数

| 字段名  | 类型   | 必填 | 说明                                           |
|--------|--------|------|------------------------------------------------|
| vin    | string | 是   | 17 位 VIN 车架号                               |
| partsNames | list | 是   | 配件名称列表，每个元素为一个字符串。 |

示例：

LSVAL41Z882104202 ["前保险杠皮","中网"]

## VIN 查询返回结果示例

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

```json
 [
    {
      "partsOe": "1ZD807221GRU",
      "aliasName": "前保险杠皮",
      "stdName": "前保险杠皮",
      "price4sSales": "1411.00",
      "price4sNet": "1007.45",
      "price4sSalesNoTax": "1248.67",
      "dummy": false,
      "oeSource": null,
      "remark": null,
      "referType": 0,
      "priceRefer": null,
      "priceSource": null
    },
    {
      "partsOe": "1ZD8536689B9",
      "aliasName": "中网",
      "stdName": "中网",
      "price4sSales": "378.00",
      "price4sNet": "292.50",
      "price4sSalesNoTax": "334.51",
      "dummy": false,
      "oeSource": null,
      "remark": null,
      "referType": 0,
      "priceRefer": null,
      "priceSource": null
    }
  ]

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

{
  "error": "api_error",
  "state": 202,
  "msg": "VIN不正确"
}

常见错误码

代号	说明
10001	参数错误
10004	VIN 不正确或无数据

在 OpenClaw 中的推荐用法

1. 用户给出车架号和待译码e配件名称列表：「帮我查一下 VIN LSVAL41Z882104202 询价配件： 前保险杠皮 中网 的 标准配件编码与标准名信息」。
2. 调用：
   python3 skills/vinoe/get_vin_oe.py LSVAL41Z882104202 '["前保险杠皮","中网"]'
3. 从返回中选取 partsOe/aliasName/stdName/price4sSales/price4sNet/price4sSalesNoTax 等字段，给出自然语言总结；