← 返回 Skills 市场
395
总下载
10
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install epc
功能描述
按品牌/车型/VIN 查 EPC 结构树、分解图与零件信息。当用户说：查一下这款大众的 EPC 爆炸图、这个零件在图里编号多少？或类似配件 EPC 问题时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据汽车配件 EPC 查询（Jisu EPC）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r
- 车型查询（
/epc/car）\r - 车型详情（
/epc/cardetail）\r - VIN 查询（
/epc/vin）\r - 车型组查询（
/epc/group）\r - 组和配件查询（
/epc/groupparts）\r \r 适合在对话中回答「这台宝马的 EPC 结构树」「这个 VIN 对应什么车型」「发动机分解图里有哪些零件、零件号和位置」等问题。\r \r
前置配置：获取 API Key\r
\r
- 前往 极速数据官网 注册账号\r
- 进入 汽车配件 EPC 查询 API 页面，点击「申请数据」\r
- 在会员中心获取 AppKey\r
- 配置 Key：\r \r \r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/epc/epc.py`\r
\r
## 使用方式\r
\r
### 1. 车型查询（/epc/car）\r
\r
```bash\r
python3 skills/epc/epc.py car '{"parentid":0}'\r
```\r
\r
`parentid=0` 时获取品牌列表，非 0 时按上级 ID 继续向下获取车型层级（具体层级结构见接口文档）。\r
\r
### 2. 车型详情（/epc/cardetail）\r
\r
```bash\r
python3 skills/epc/epc.py cardetail '{"carid":629}'\r
```\r
\r
### 3. VIN 查询（/epc/vin）\r
\r
```bash\r
python3 skills/epc/epc.py vin '{"vin":"LE4HG5EB3AL999908"}'\r
```\r
\r
### 4. 车型组查询（/epc/group）\r
\r
```bash\r
# 基于 carid\r
python3 skills/epc/epc.py group '{"carid":630,"parentid":0}'\r
\r
# 或基于 vin（carid / vin 任选其一）\r
python3 skills/epc/epc.py group '{"vin":"LE4HG5EB3AL999908","parentid":0}'\r
```\r
\r
> 根据返回的 `isend` 和 `isgraph` 字段，递归调用 `/epc/group` 直到到达含有分解图的组或最后一级：\r
> - `isend=1,isgraph=1`：图片在最后一级；\r
> - `isend=0,isgraph=1`：图片不在最后一级，需继续按 `grouptype>0` 的组向下；\r
> - `isend=1,isgraph=0`：组结束，无分解图和配件。\r
\r
### 5. 组和配件查询（/epc/groupparts）\r
\r
```bash\r
python3 skills/epc/epc.py groupparts '{"carid":630,"parentid":3}'\r
```\r
\r
`parentid` 为某一组的 ID，对应 `/epc/group` 返回的 `list[].id`。\r
\r
## 请求参数摘要\r
\r
### /epc/car\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|----------|------|------|----------|\r
| parentid | int | 是 | 上级 ID |\r
\r
### /epc/cardetail\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|------|------|--------|\r
| carid | int | 是 | 车型 ID |\r
\r
### /epc/vin\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|--------|------|-------|\r
| vin | string | 是 | VIN |\r
\r
### /epc/group\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|----------|--------|------|----------------------------------------|\r
| parentid | int | 是 | 上级 ID |\r
| carid | int | 否 | 车型 ID，carid 与 vin 需至少提供一个 |\r
| vin | string | 否 | VIN，carid 与 vin 需至少提供一个 |\r
\r
### /epc/groupparts\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|----------|------|------|--------|\r
| parentid | int | 是 | 上级 ID（组 ID） |\r
| carid | int | 是 | 车型 ID |\r
\r
## 返回结果概览（节选）\r
\r
### /epc/car\r
\r
```json\r
[\r
{\r
"id": 9,\r
"name": "奔驰",\r
"initial": "B",\r
"parentid": 0,\r
"logo": "http://pic1.jisuapi.cn/epc/upload/car/9.png",\r
"type": 1\r
}\r
]\r
```\r
\r
### /epc/cardetail\r
\r
```json\r
{\r
"carid": 629,\r
"name": "114d",\r
"parentname": "F20",\r
"intername": "F20",\r
"salecode": "1T91",\r
"market": "ECE",\r
"brand": "宝马",\r
"bodytype": "SH",\r
"enginemodel": "N47N",\r
"steertype": "L",\r
"startdate": "2012-11-02",\r
"enddate": null,\r
"remark": null\r
}\r
```\r
\r
### /epc/vin\r
\r
```json\r
{\r
"carid": 3981,\r
"name": "530Li",\r
"intername": "F18N",\r
"parentname": "F18 LCI",\r
"market": "CHN",\r
"brand": "宝马",\r
"bodytype": "Lim",\r
"enginemodel": "N52N",\r
"productiondate": "2014-01"\r
}\r
```\r
\r
### /epc/group\r
\r
返回包含整车信息和组列表的对象（字段较多，这里仅示意）：\r
\r
```json\r
{\r
"parentid": 0,\r
"car": {\r
"carid": 630,\r
"name": "114d",\r
"parentname": "F20",\r
"salecode": "1T92",\r
"market": "ECE",\r
"brand": "宝马"\r
},\r
"list": [\r
{\r
"id": 240,\r
"code": "11",\r
"isgraph": 0,\r
"isend": 0,\r
"name": "发动机",\r
"enname": "ENGINE",\r
"pic": "http://pic1.jisuapi.cn/epc/upload/group/..."\r
}\r
]\r
}\r
```\r
\r
### /epc/groupparts\r
\r
返回每个分解图下的零件清单（含零件号、数量、配置代码和坐标信息），可用于前端绘制可点击的分解图热点区域。\r
\r
## 错误返回示例\r
\r
```json\r
{\r
"error": "api_error",\r
"code": 201,\r
"message": "上级ID错误"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据汽车配件 EPC 文档](https://www.jisuapi.com/api/epc/)：\r
\r
| 代号 | 说明 |\r
|------|------------------|\r
| 201 | 上级 ID 错误 |\r
| 202 | 车型 ID 错误 |\r
| 203 | 此 VIN 没有 EPC 信息 |\r
| 204 | 请直接获取分解图和配件 |\r
| 205 | 零件号为空 |\r
| 220 | 没有信息 |\r
\r
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无请求此数据权限、104 请求超过次数限制、105 IP 被禁止、106 IP 请求超过限制、107 接口维护中、108 接口已停用。\r
\r
## 推荐用法\r
\r
1. 用户：「查一下这台车（VIN）的 EPC 结构树」→ 先 `vin` 获得 `carid`，再从 `group` 开始递归，构建一棵按组划分的 EPC 树，并可结合 `groupparts` 补充具体零件。 \
\r
2. 用户：「帮我看 114d 发动机分解图里的零件号」→ 根据已知 `carid` 调用 `group` 找到发动机相关组，再用对应 `parentid` 调 `groupparts`，整理零件号、名称和数量。 \
\r
3. 用户：「按品牌浏览 EPC」→ 通过 `car {"parentid":0}` 获取品牌列表，再逐步下钻到具体车型、车系和配置，配合对话进行导航。 \
\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill appears to do exactly what it claims: query JisuAPI's EPC endpoints using your JISU_API_KEY. Before installing, ensure you trust the JisuAPI service and are comfortable sending VINs and car identifiers to it (check their privacy/terms). Make sure the runtime has Python 3 and the 'requests' library installed (pip install requests) so the script can run. Verify your AppKey's permissions, quota, and whether you want the skill to see VINs (VINs can be sensitive). Otherwise the request surface is narrow and proportionate.
功能分析
Type: OpenClaw Skill
Name: epc
Version: 1.0.2
The skill bundle is a legitimate integration for the JisuAPI Electronic Parts Catalog (EPC) service. The Python script (epc.py) provides a clean wrapper for querying automotive parts data via standard HTTP GET requests to api.jisuapi.com, and the documentation (SKILL.md) contains no malicious instructions or prompt injection attempts.
能力评估
Purpose & Capability
Name/description request VIN/brand/model EPC data and the skill only requires a JISU (JisuAPI) AppKey and Python to call JisuAPI's /epc endpoints — this is coherent with the stated purpose.
Instruction Scope
SKILL.md instructs setting JISU_API_KEY and running the included Python script with JSON arguments; runtime behavior is limited to calling the documented JisuAPI endpoints and returning results. No unrelated file reads, other env vars, or unexpected external endpoints are referenced.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. One minor inconsistency: the Python script uses the third‑party 'requests' library but the manifest only lists 'python3' as a required binary and does not declare installing 'requests' (user should ensure requests is available).
Credentials
Only JISU_API_KEY is required and is the expected AppKey for JisuAPI. No other credentials, keys, or sensitive config paths are requested.
Persistence & Privilege
Skill is not 'always' enabled and does not request elevated or persistent platform privileges. It performs ordinary network calls and prints results.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install epc - 安装完成后，直接呼叫该 Skill 的名称或使用
/epc触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
Version 1.0.2
- 更新技能名称和描述，更明确功能和适用场景。
- SKILL.md 新增了详细的「前置配置」「关于极速数据」与 API 介绍说明，适配新用户指引。
- 保留和优化全部接口示例、参数表和推荐用法，结构更简明。
- 不涉及代码文件变化，仅文档优化与信息补充。
v1.0.1
- No user-facing changes; documentation and skill behavior remain the same.
- Version bump to 1.0.1 with no file changes detected.
v1.0.0
Initial release of the 极速数据汽车配件 EPC 查询 skill.
- Provides API access for querying car brands, models, VINs, EPC structure trees, group breakdowns, and parts details via Jisu API.
- Supports command-line operations for all key endpoints, including car, cardetail, vin, group, and groupparts.
- Includes Chinese documentation and usage examples for each command.
- Lists configuration requirements, including environment variables and script paths.
- Summarizes API parameters, example responses, and typical error codes for robust integration.
元数据
常见问题
EPC Query For Auto Parts - 汽车配件EPC查询 是什么？
按品牌/车型/VIN 查 EPC 结构树、分解图与零件信息。当用户说：查一下这款大众的 EPC 爆炸图、这个零件在图里编号多少？或类似配件 EPC 问题时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 395 次。
如何安装 EPC Query For Auto Parts - 汽车配件EPC查询？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install epc」即可一键安装，无需额外配置。
EPC Query For Auto Parts - 汽车配件EPC查询 是免费的吗？
是的，EPC Query For Auto Parts - 汽车配件EPC查询 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
EPC Query For Auto Parts - 汽车配件EPC查询 支持哪些平台？
EPC Query For Auto Parts - 汽车配件EPC查询 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 EPC Query For Auto Parts - 汽车配件EPC查询？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.2。
推荐 Skills