极速数据汽车配件OE信息查询(Jisu Parts)
基于 汽车配件OE信息查询 API 的 OpenClaw 技能,提供:
- 配件品牌(
/parts/brand):获取配件品牌列表 - 原厂零件号模糊搜索(
/parts/search):按零件号搜索 OE 信息及多品牌匹配 - 零件号查销售车型(
/parts/salecar):查某零件号/品牌/零件 ID 对应的销售车型 - 查询替换件(
/parts/replace):查某原厂件的替换件、品牌件
可用于对话中回答「这个零件号有哪些品牌在用」「L8WD807065K 适配哪些车」「04E115561C 的替换件有哪些」等问题。
使用技能前需要申请数据,申请地址:https://www.jisuapi.com/api/parts/
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件:skills/parts/parts.py
使用方式
1. 配件品牌(brand)
python3 skills/parts/parts.py brand
2. 原厂零件号模糊搜索(search)
python3 skills/parts/parts.py search '{"number":"L8WD807065KGRU"}'
3. 零件号查销售车型(salecar)
# 零件号 + 品牌ID
python3 skills/parts/parts.py salecar '{"number":"L8WD807065KGRU","brandid":219}'
# 仅品牌ID 或 仅零件ID 也可
python3 skills/parts/parts.py salecar '{"partsid":23064200}'
4. 查询替换件(replace)
# 零件号 + 品牌ID
python3 skills/parts/parts.py replace '{"number":"01402917258","brandid":10}'
# 或零件ID
python3 skills/parts/parts.py replace '{"partsid":12656367}'
请求参数摘要
| 子命令 | 必填/组合说明 | 参数说明 |
|---|---|---|
| brand | 无参数 | — |
| search | number(必填) | 零件号 |
| salecar | number / brandid / partsid 任选一或组合 | number、brandid、partsid 至少传一个 |
| replace | partsid 或 number+brandid | number、brandid、partsid 任选一组 |
返回结果说明
脚本直接输出接口的 result 字段(JSON):
- brand:数组,每项含
brandid、name。 - search:对象,含
list数组,每项含partsid、number、number2、brand、name、stdname、marketprice、remark等。 - salecar:对象,含
brandid、number、number2、partsid、brand及list(销售车型列表,含carid、fullname、price、yeartype、listdate、productionstate、salestate、sizetype、displacement、geartype等)。 - replace:对象,含
partsid、name、brand、brandid、number及list(替换件列表,含partsid、number、name、stdname、brandid、brand等)。
错误时输出形如:
{
"error": "api_error",
"code": 202,
"message": "配件ID错误"
}
常见错误码
来自 极速数据汽车配件OE文档:
| 代号 | 说明 |
|---|---|
| 201 | 零件ID和零件号不能都为空 |
| 202 | 配件ID错误 |
| 220 | 没有信息 |
系统错误码:101 APPKEY 为空或不存在、102 已过期、103 无权限、104 超过次数限制、105 IP 被禁止、106 IP 超限、107 接口维护中、108 接口已停用。
在 OpenClaw 中的推荐用法
- 用户:「有哪些配件品牌?」→
parts.py brand。 - 用户:「零件号 L8WD807065KGRU 有哪些品牌?」→
parts.py search '{"number":"L8WD807065KGRU"}'。 - 用户:「这个零件能用在哪些车上?」→ 先 search 或确定 brandid/partsid,再
parts.py salecar '{"number":"...","brandid":219}'。 - 用户:「04E115561C 的替换件」→
parts.py replace '{"number":"04E115561C","brandid":10}'或按零件 ID 查询,解析返回的list为用户总结。