---
name: vehicle-industry-base-data
description: "当用户需要使用咕咕数据公开 API 完成汽车内容平台、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 车辆与行业基础数据 Skill

面向汽车品牌、车系、车型以及行业基础库查询的公开 API 组合。

## 业务场景

用于汽车品牌、车系、车型和行业基础数据查询。适合汽车内容平台、车型库、线索表单、车辆资料检索和行业资料整理。

- 数据范围：覆盖汽车品牌、车系、车型等车辆基础资料，适合做汽车内容和资料查询的基础层。
- 关键数据维度：品牌维度：品牌名称、厂商、国家地区和品牌层级。；车系维度：车系名称、品牌归属、级别和能源类型。；车型维度：车型名称、年份、配置、指导价和基础参数。

## 何时使用

- 查询汽车品牌、车系、车型和基础资料。
- 为汽车页面、车型筛选、询价表单和资料库提供标准名称。
- 把分散的车型信息整理成可搜索、可筛选的数据结构。

## 不适用场景

- 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
- 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
- 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

## 用户需要提供的信息

- 汽车品牌、车系、车型、年款、能源类型或筛选条件。
- 输出目标：车型库、筛选页、资料详情或行业数据整理。
- 调用接口所需的 AppKey、开通状态和接口详情页限制。

## 推荐工作流

1. 先查询品牌和车系列表。
2. 再查询车系详情和车型列表。
3. 需要站点展示时，可结合图片、页面生成和二维码接口完成车型资料展示。

## 参数传递关系

- 先确定品牌，再用品牌筛选车系，最后用车系和年款筛选车型。
- 车型结果需要保留品牌、车系、车型和年款层级，避免同名车型混淆。
- 价格和配置字段适合展示和筛选，关键交易场景需要复核官方或经销商信息。

## 典型任务模板

- 车型筛选：输入品牌、车系、年款或能源类型；输出车型列表和关键属性。
- 车型详情：输入车型名称或层级条件；输出品牌、车系、车型、配置和复核提示。
- 资料入库：输入品牌或车系；输出标准名称层级和展示字段。

## 接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 `appkey` 仍以接口详情页说明为准。

### 汽车车型库数据

- 业务角色：汽车车型库
- 调用阶段：车辆数据
- 接口地址：`GET https://api.gugudata.com/v1/vehicleBrands`
- 产出用途：用于查询汽车品牌、车系、车系详情和车型列表。
- 参数来源：关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
- 可参考的相关能力：获取品牌下车系列表、获取车系详情、获取车型列表
- 接口详情页：https://www.gugudata.com/api/details/vehicle-catalog
- 接口 Markdown：https://www.gugudata.com/api/details/vehicle-catalog/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `keyword` | 否 | `string` | 特斯拉 | 品牌关键词，支持品牌名称或拼音首字母模糊查询 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageIndex` | 否 | `integer` | 1 | 页码，从 1 开始 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 50 | 每页返回数量，默认 50，最大 100 | 分页参数由调用方控制，用于分批读取结果 |

### URL 生成网站截图

- 业务角色：页面截图
- 调用阶段：展示材料
- 接口地址：`GET https://api.gugudata.com/websitetools/url2image`
- 产出用途：用于生成车型或资料页截图。
- 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
- 接口详情页：https://www.gugudata.com/api/details/url2image
- 接口 Markdown：https://www.gugudata.com/api/details/url2image/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | YOUR_VALUE | 需要截取的网页 URL 地址 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `width` | 否 | `integer` | 250 | 输出截图的宽度，默认值为 250 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `height` | 否 | `integer` | 250 | 输出截图的高度，默认值为 250 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `viewportWidth` | 否 | `integer` | 1080 | 渲染视窗的宽度，默认值为 1080 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `viewportHeight` | 否 | `integer` | 1080 | 渲染视窗的高度，默认值为 1080 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `forceReload` | 否 | `boolean` | false | 强制重新加载已保存的图片，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isMobile` | 否 | `boolean` | false | 是否以移动设备的 User Agent 渲染，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isFullPage` | 否 | `boolean` | false | 是否截取整个页面而非视窗裁剪，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isDarkMode` | 否 | `boolean` | false | 是否优先采用深色模式，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 通用二维码生成

- 业务角色：二维码生成
- 调用阶段：展示材料
- 接口地址：`GET https://api.gugudata.com/barcode/qrcode`
- 产出用途：用于生成资料页或落地页二维码。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口详情页：https://www.gugudata.com/api/details/qrcode
- 接口 Markdown：https://www.gugudata.com/api/details/qrcode/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | YOUR_VALUE | 二维码内容，网址类型智能识别 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `size` | 否 | `integer` | 500 | 正整数，二维码尺寸像素，默认为 500 像素 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 通用条形码生成

- 业务角色：条码生成
- 调用阶段：展示材料
- 接口地址：`GET https://api.gugudata.com/barcode/barcode`
- 产出用途：用于生成通用条形码。
- 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
- 接口详情页：https://www.gugudata.com/api/details/barcode
- 接口 Markdown：https://www.gugudata.com/api/details/barcode/llm.md

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | YOUR_VALUE | 条码类型，可选项: UNSPECIFIED\|UPCA\|UPCE\|UPC_SUPPLEMENTAL_2DIGIT\|UPC_SUPPLEMENTAL_5DIGIT\|EAN13\|EAN8\|Interleaved2of5\|Interleaved2of5_Mod10\|Standard2of5\|Standard2of5_Mod10\|Industrial2of5\|Industrial2of5_Mod10\|CODE39\|CODE39Extended\|CODE39_Mod43\|Codabar\|PostNet\|BOOKLAND\|ISBN\|JAN13\|MSI_Mod10\|MSI_2Mod10\|MSI_Mod11\|MSI_Mod11_Mod10\|Modified_Plessey\|CODE11\|USD8\|UCC12\|UCC13\|LOGMARS\|CODE128\|CODE128A\|CODE128B\|CODE128C\|ITF14\|CODE93\|TELEPEN\|FIM\|PHARMACODE | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `content` | 是 | `string` | YOUR_VALUE | 条码内容，注意对应条码的长度规范 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `width` | 是 | `integer` | YOUR_VALUE | 条码宽度像素值 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `height` | 是 | `integer` | YOUR_VALUE | 条码高度像素值 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `showLabel` | 否 | `boolean` | false | 控制是否显示条码底部的文字标签，默认不显示，需要显示传递 true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

## 数据校验与使用边界

- 车型数据更新受厂商发布节奏影响，价格和配置需以官方或经销商信息复核。
- 同名车系、改款和年款容易混淆，应保留品牌、车系、车型层级。
- 行业数据只用于资料展示和检索，不替代交易报价。

## 输出建议

- 输出车型结果时按品牌、车系、车型三级展示。
- 用于筛选页时保留能源、级别、年份等关键筛选项。
- 对缺少价格或配置的车型标注待复核。

## 常见问题

- 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
- 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
- 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
- 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
- 问：车辆与行业基础数据 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。