\r \r

极速数据车型大全（Jisu Car）\r

\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r

• 获取所有品牌（/car/brand）\r
• 根据品牌获取车型（/car/type）\r
• 根据车型获取车款（/car/car）\r
• 根据 ID 获取车型详情（/car/detail）\r
• 车型搜索（/car/search）\r
• 获取热门车型（/car/hot）\r
• 获取销量排行榜（/car/rank）\r \r 可用于对话中回答「某品牌有哪些车系和车款」「这款车的详细配置」「当前热门 SUV」「本月销量排行前十车型」等问题。\r \r

前置配置：获取 API Key\r

\r

1. 前往 极速数据官网 注册账号\r
2. 进入 车型大全 API 页面，点击「申请数据」\r
3. 在会员中心获取 AppKey\r
4. 配置 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/car/car.py`\r
\r
## 使用方式\r
\r
### 1. 获取所有品牌（brand）\r
\r
```bash\r
python3 skills/car/car.py brand\r
```\r
\r
### 2. 根据品牌获取车型（type）\r
\r
```bash\r
python3 skills/car/car.py type '{"parentid":"1"}'\r
```\r
\r
### 3. 根据车型获取车款（car）\r
\r
```bash\r
python3 skills/car/car.py car '{"parentid":"220"}'\r
```\r
\r
可选参数：`sort`（如 `year`、`yearr` 等）、`isnev`（`1` 仅返回新能源）。\r
\r
### 4. 根据 ID 获取车型详情（detail）\r
\r
```bash\r
python3 skills/car/car.py detail '{"carid":2571}'\r
```\r
\r
### 5. 车型搜索（search）\r
\r
```bash\r
python3 skills/car/car.py search '{"keyword":"奔驰E级2017款E200运动版"}'\r
```\r
\r
### 6. 热门车型（hot）\r
\r
```bash\r
# 不指定价格区间：返回 5–50 万热门车型\r
python3 skills/car/car.py hot '{}'\r
\r
# 指定价格区间：1=5-8万 2=8-15万 3=15-20万 4=20-30万 5=30-50万\r
python3 skills/car/car.py hot '{"pricetype":"2"}'\r
```\r
\r
### 7. 销量排行榜（rank）\r
\r
```bash\r
python3 skills/car/car.py rank '{"ranktype":"1","month":"2025-01","week":""}'\r
```\r
\r
`ranktype`：`1` 车型排名，`2` 品牌排名。`month` 格式 `xxxx-xx`，`week` 格式 `xxxx-xx-xx`（周一日期）。\r
\r
## 请求参数摘要\r
\r
| 子命令   | 必填参数      | 可选参数                          |\r
|----------|---------------|-----------------------------------|\r
| type     | parentid      | —                                 |\r
| car      | parentid      | sort, isnev                       |\r
| detail   | carid         | —                                 |\r
| search   | keyword       | —                                 |\r
| hot      | —             | pricetype（1–5）                  |\r
| rank     | ranktype      | month, week                       |\r
\r
## 返回结果说明\r
\r
脚本直接输出接口的 `result` 字段（JSON）。结构因接口而异：\r
\r
- **brand**：数组，每项含 `id`、`name`、`initial`、`parentid`、`logo`、`depth`。\r
- **type**：数组，每项含品牌/子公司及下属车型列表 `list`。\r
- **car**：对象，含车系信息及具体车款列表 `list`（含 id、name、price、yeartype、salestate、sizetype 等）。\r
- **detail**：对象，含车型完整详情（basic、body、engine、gearbox、safe 等）。\r
- **search**：对象，含 `keyword` 与匹配的 `list`。\r
- **hot**：数组，按车型类型分组的热门车系（sizetype、name、carid）。\r
- **rank**：对象，含 `date`、`week`、`ranktype` 及 `list`（carid、num、type、cartype 等）。\r
\r
错误时输出形如：\r
\r
```json\r
{\r
  "error": "api_error",\r
  "code": 202,\r
  "message": "车型ID错误"\r
}\r
```\r
\r
## 常见错误码\r
\r
来自 [极速数据车型大全文档](https://www.jisuapi.com/api/car)：\r
\r
| 代号 | 说明       |\r
|------|------------|\r
| 201  | 上级ID错误 |\r
| 202  | 车型ID错误 |\r
| 205  | 没有信息   |\r
\r
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无权限、104 超过次数限制、105 IP 被禁止、106 IP 超限、107 接口维护中、108 接口已停用。\r
\r
## 推荐用法\r
\r
1. 用户例如：「奥迪有哪些车系？」→ 先 `brand` 查奥迪 id，再 `type '{"parentid":"1"}'`（以实际 id 为准）。  \r
2. 「奥迪 A3 有哪些具体车款？」→ `car '{"parentid":"220"}'`。  \r
3. 「查一下车 ID 2571 的详细配置」→ `detail '{"carid":2571}'`。  \r
4. 「搜一下奔驰 E 级 2017 款」→ `search '{"keyword":"奔驰E级2017款"}'`。  \r
5. 「当前热门 SUV / 8–15 万热门车」→ `hot '{"pricetype":"2"}'`，再根据返回解析。  \r
6. 「本月销量前十车型」→ `rank '{"ranktype":"1","month":"2025-01"}'`，解析 `list` 并可选结合 detail 补全名称。\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