EPC Query For Auto Parts - 汽车配件EPC查询

Verified

EPC Query For Auto Parts 汽车配件EPC查询 — software development tool with VIN support.

71 downloads

$ Add to .claude/skills/

$ openclaw install

About This Skill

Content available in Chinese

# 极速数据汽车配件 EPC 查询（Jisu EPC）
基于汽车配件 EPC 查询 API 的 OpenClaw 技能，支持：
车型查询（`/epc/car`）
车型详情（`/epc/cardetail`）
VIN 查询（`/epc/vin`）
车型组查询（`/epc/group`）
组和配件查询（`/epc/groupparts`）
适合在对话中回答「这台宝马的 EPC 结构树」「这个 VIN 对应什么车型」「发动机分解图里有哪些零件、零件号和位置」等问题。
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/epc/
## 环境变量配置
```bash
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
```
## 脚本路径
脚本文件：`skills/epc/epc.py`
## 使用方式
### 1. 车型查询（/epc/car）
```bash
python3 skills/epc/epc.py car '{"parentid":0}'
```
`parentid=0` 时获取品牌列表，非 0 时按上级 ID 继续向下获取车型层级（具体层级结构见接口文档）。
### 2. 车型详情（/epc/cardetail）
```bash
python3 skills/epc/epc.py cardetail '{"carid":629}'
```
### 3. VIN 查询（/epc/vin）
```bash
python3 skills/epc/epc.py vin '{"vin":"LE4HG5EB3AL999908"}'
```
### 4. 车型组查询（/epc/group）
```bash
# 基于 carid
python3 skills/epc/epc.py group '{"carid":630,"parentid":0}'
# 或基于 vin（carid / vin 任选其一）
python3 skills/epc/epc.py group '{"vin":"LE4HG5EB3AL999908","parentid":0}'
```
> 根据返回的 `isend` 和 `isgraph` 字段，递归调用 `/epc/group` 直到到达含有分解图的组或最后一级：
> - `isend=1,isgraph=1`：图片在最后一级；
> - `isend=0,isgraph=1`：图片不在最后一级，需继续按 `grouptype>0` 的组向下；
> - `isend=1,isgraph=0`：组结束，无分解图和配件。
### 5. 组和配件查询（/epc/groupparts）
```bash
python3 skills/epc/epc.py groupparts '{"carid":630,"parentid":3}'
```
`parentid` 为某一组的 ID，对应 `/epc/group` 返回的 `list[].id`。
## 请求参数摘要
### /epc/car
| 字段名 | 类型 | 必填 | 说明 |
|----------|------|------|----------|
| parentid | int | 是 | 上级 ID |
### /epc/cardetail
| 字段名 | 类型 | 必填 | 说明 |
|--------|------|------|--------|
| carid | int | 是 | 车型 ID |
### /epc/vin
| 字段名 | 类型 | 必填 | 说明 |
|--------|--------|------|-------|
| vin | string | 是 | VIN |
### /epc/group
| 字段名 | 类型 | 必填 | 说明 |
|----------|--------|------|----------------------------------------|
| parentid | int | 是 | 上级 ID |
| carid | int | 否 | 车型 ID，carid 与 vin 需至少提供一个 |
| vin | string | 否 | VIN，carid 与 vin 需至少提供一个 |
### /epc/groupparts
| 字段名 | 类型 | 必填 | 说明 |
|----------|------|------|--------|
| parentid | int | 是 | 上级 ID（组 ID） |
| carid | int | 是 | 车型 ID |
## 返回结果概览（节选）
### /epc/car
```json
[
{
"id": 9,
"name": "奔驰",
"initial": "B",
"parentid": 0,
"logo": "http://pic1.jisuapi.cn/epc/upload/car/9.png",
"type": 1
}
]
```
### /epc/cardetail
```json
{
"carid": 629,
"name": "114d",
"parentname": "F20",
"intername": "F20",
"salecode": "1T91",
"market": "ECE",
"brand": "宝马",
"bodytype": "SH",
"enginemodel": "N47N",
"steertype": "L",
"startdate": "2012-11-02",
"enddate": null,
"remark": null
}
```
### /epc/vin
```json
{
"carid": 3981,
"name": "530Li",
"intername": "F18N",
"parentname": "F18 LCI",
"market": "CHN",
"brand": "宝马",
"bodytype": "Lim",
"enginemodel": "N52N",
"productiondate": "2014-01"
}
```
### /epc/group
返回包含整车信息和组列表的对象（字段较多，这里仅示意）：
```json
{
"parentid": 0,
"car": {
"carid": 630,
"name": "114d",
"parentname": "F20",
"salecode": "1T92",
"market": "ECE",
"brand": "宝马"
},
"list": [
{
"id": 240,
"code": "11",
"isgraph": 0,
"isend": 0,
"name": "发动机",
"enname": "ENGINE",
"pic": "http://pic1.jisuapi.cn/epc/upload/group/..."
}
]
}
```
### /epc/groupparts
返回每个分解图下的零件清单（含零件号、数量、配置代码和坐标信息），可用于前端绘制可点击的分解图热点区域。
## 错误返回示例
```json
{
"error": "api_error",
"code": 201,
"message": "上级ID错误"
}
```
## 常见错误码
来源于极速数据汽车配件 EPC 文档：
| 代号 | 说明 |
|------|------------------|
| 201 | 上级 ID 错误 |
| 202 | 车型 ID 错误 |
| 203 | 此 VIN 没有 EPC 信息 |
| 204 | 请直接获取分解图和配件 |
| 205 | 零件号为空 |
| 220 | 没有信息 |
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无请求此数据权限、104 请求超过次数限制、105 IP 被禁止、106 IP 请求超过限制、107 接口维护中、108 接口已停用。
## 在 OpenClaw 中的推荐用法
1. 用户：「查一下这台车（VIN）的 EPC 结构树」→ 先 `vin` 获得 `carid`，再从 `group` 开始递归，构建一棵按组划分的 EPC 树，并可结合 `groupparts` 补充具体零件。 \n
2. 用户：「帮我看 114d 发动机分解图里的零件号」→ 根据已知 `carid` 调用 `group` 找到发动机相关组，再用对应 `parentid` 调 `groupparts`，整理零件号、名称和数量。 \n
3. 用户：「按品牌浏览 EPC」→ 通过 `car {"parentid":0}` 获取品牌列表，再逐步下钻到具体车型、车系和配置，配合对话进行导航。 \n

Use Cases

Manage EPC (Engineering, Procurement, Construction) project workflows
Track project milestones, deliverables, and resource allocation for EPC projects
Generate project status reports with schedule adherence and cost tracking
Coordinate between engineering, procurement, and construction phases
Manage material requisitions and vendor communication for EPC projects

Pros & Cons

Pros

+Purpose-built for EPC industry workflows rather than generic project management
+Phase coordination ensures handoffs between engineering, procurement, and construction
+Material tracking reduces procurement delays and cost overruns

Cons

-Documentation primarily in Chinese
-Only available on claude-code and openclaw platforms
-Niche industry tool — not relevant for software-only projects

FAQ

What does EPC Query For Auto Parts - 汽车配件EPC查询 do?

EPC Query For Auto Parts 汽车配件EPC查询 — software development tool with VIN support.

What platforms support EPC Query For Auto Parts - 汽车配件EPC查询?

EPC Query For Auto Parts - 汽车配件EPC查询 is available on Claude Code, OpenClaw.

What are the use cases for EPC Query For Auto Parts - 汽车配件EPC查询?

Manage EPC (Engineering, Procurement, Construction) project workflows. Track project milestones, deliverables, and resource allocation for EPC projects. Generate project status reports with schedule adherence and cost tracking.

100+ free AI tools

Writing, PDF, image, and developer tools — all in your browser.

AI Humanizer

Make AI text undetectable

AI Detector

Free, unlimited

PDF Tools

Merge, split, compress

Next Step

Use the skill detail page to evaluate fit and install steps. For a direct browser workflow, move into a focused tool route instead of staying in broader support surfaces.

Open Free Tools Try AI Detector