车辆与行业基础数据 Skill

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

业务场景

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

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

何时使用

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

不适用场景

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

用户需要提供的信息

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

推荐工作流

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

参数传递关系

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

典型任务模板

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

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 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 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。