高考内容运营与问答助手 Skill

面向高考内容运营、院校问答助手、招生专题页和志愿咨询线索的公开 API 组合。

业务场景

用于高考内容运营、院校问答助手、招生专题页、志愿咨询线索和教育内容分发。适合把院校、专业、招生计划、分数线、一分一段、录取概率、高考问答、文章抽取、封面、摘要和二维码组合成内容到咨询的业务链路。

• 数据范围：覆盖院校库、专业库、招生计划、院校录取线、一分一段、录取概率、高考问答、文章正文、公众号封面、文章结构化、文本摘要和二维码。
• 关键数据维度：教育维度：院校、专业、年份、省份、批次、选科、分数、位次和录取概率。；内容维度：文章 URL、标题、正文、封面、摘要、关键词和发布渠道。；转化维度：咨询页 URL、二维码、活动页和用户输入字段。

何时使用

• 生成院校介绍、专业解读、招生计划摘要和志愿问答材料。
• 把外部文章、公众号封面和高考数据结合成专题内容。
• 为咨询页、讲座页或院校页生成可传播二维码。

不适用场景

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

用户需要提供的信息

• 目标省份、年份、院校或专业名称、考生分数位次、内容主题、文章 URL 和发布渠道。
• 输出目标：院校介绍、专业解读、招生问答、志愿专题页或活动二维码。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先用院校、专业、招生计划、分数线和一分一段确认教育数据事实。
2. 再结合高考问答、文章抽取、封面和摘要接口生成内容素材。
3. 最后把专题页或咨询页链接生成二维码用于传播。

参数传递关系

• 先用院校、专业、招生计划和分数线接口确认教育数据事实，再把事实传给高考问答或摘要接口生成解释。
• 文章 URL 或公众号链接先抽取正文、封面和结构化内容，再和院校数据合并成内容素材。
• 分数、位次、年份、省份、批次和选科参数必须和高考志愿数据接口保持同一口径。
• 活动页、咨询页或院校页 URL 可传给二维码接口，输出给线上线下传播使用。

典型任务模板

• 院校内容页：输入院校名称和省份；输出院校基础信息、招生计划、近年录取线、内容摘要和二维码。
• 志愿问答助手：输入考生省份、分数、位次和偏好；输出问答解释、推荐接口链路和风险提示。
• 招生专题复用：输入文章 URL 和目标院校；输出封面、正文摘要、相关院校数据和发布建议。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 appkey 仍以接口详情页说明为准。

全国大学高校基础信息

• 业务角色：院校基础库
• 调用阶段：教育数据
• 接口地址：GET https://api.gugudata.com/location/college
• 产出用途：用于查询院校基础信息。
• 参数来源：院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；SchoolUUID 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
• 接口资料：详情页 https://www.gugudata.com/api/details/college；接口 Markdown https://www.gugudata.com/api/details/college/llm.md

关键请求参数：

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/college/llm.md

全国大学高校专业数据

• 业务角色：专业基础库
• 调用阶段：教育数据
• 接口地址：GET https://api.gugudata.com/metadata/ceemajor
• 产出用途：用于查询专业基础信息。
• 参数来源：院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；分页参数由调用方控制，用于分批读取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/ceemajor；接口 Markdown https://www.gugudata.com/api/details/ceemajor/llm.md

关键请求参数：

历年高校招生计划数据

• 业务角色：招生计划
• 调用阶段：教育数据
• 接口地址：GET https://api.gugudata.com/metadata/college-enrollment-plan
• 产出用途：用于查询高校招生计划。
• 参数来源：year 使用考生关注的招生年份、考试年份或历史对比年份；分页参数由调用方控制，用于分批读取结果；SchoolUUID 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询
• 可参考的相关能力：历年高校招生计划数据-查询参数枚举、历年高校招生计划数据-院校招生代码查询
• 接口资料：详情页 https://www.gugudata.com/api/details/collegeenrollmentplan；接口 Markdown https://www.gugudata.com/api/details/collegeenrollmentplan/llm.md

关键请求参数：

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/collegeenrollmentplan/llm.md

历年高考高校录取分数线

• 业务角色：院校录取线
• 调用阶段：教育数据
• 接口地址：GET https://api.gugudata.com/metadata/ceecollegeline
• 产出用途：用于查询院校历年录取分数线。
• 参数来源：year 使用考生关注的招生年份、考试年份或历史对比年份；关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
• 可参考的相关能力：历年高考高校录取分数线-查询参数枚举
• 接口资料：详情页 https://www.gugudata.com/api/details/ceecollegeline；接口 Markdown https://www.gugudata.com/api/details/ceecollegeline/llm.md

关键请求参数：

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/ceecollegeline/llm.md

历年高考一分一段数据

• 业务角色：一分一段
• 调用阶段：教育数据
• 接口地址：GET https://api.gugudata.com/metadata/ceeline/one-score-one-section
• 产出用途：用于分数与位次关系分析。
• 参数来源：year 使用考生关注的招生年份、考试年份或历史对比年份；省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举；score 为用户高考分数，用于一分一段和录取概率分析
• 可参考的相关能力：历年高考一分一段数据-查询参数枚举、历年高考一分一段数据-科目类型枚举（兼容路由）
• 接口资料：详情页 https://www.gugudata.com/api/details/ceeline-one-score-one-section；接口 Markdown https://www.gugudata.com/api/details/ceeline-one-score-one-section/llm.md

关键请求参数：

高校志愿录取机会与梯度评估模型

• 业务角色：录取概率
• 调用阶段：智能分析
• 接口地址：POST https://api.gugudata.com/ai/admission/predict
• 产出用途：用于志愿推荐和录取概率说明。
• 参数来源：省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举；score 为用户高考分数，用于一分一段和录取概率分析；SchoolUUID 来自院校基础信息查询结果，也可以由用户指定院校后查询获得
• 可参考的相关能力：专业录取线按录取概率排序
• 接口资料：详情页 https://www.gugudata.com/api/details/admission-predict；接口 Markdown https://www.gugudata.com/api/details/admission-predict/llm.md

关键请求参数：

完整请求参数、响应字段和调用示例以接口 Markdown 为准：https://www.gugudata.com/api/details/admission-predict/llm.md

高考教育信息智能助手

• 业务角色：高考问答
• 调用阶段：智能问答
• 接口地址：POST https://api.gugudata.com/ai/gaokao/chat
• 产出用途：用于生成高考业务问答。
• 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
• 接口资料：详情页 https://www.gugudata.com/api/details/gaokao-chat；接口 Markdown https://www.gugudata.com/api/details/gaokao-chat/llm.md

关键请求参数：

获取任意链接文章正文

• 业务角色：文章正文
• 调用阶段：内容抽取
• 接口地址：POST https://api.gugudata.com/news/fetchcontent
• 产出用途：用于抽取外部文章正文。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/fetchcontent；接口 Markdown https://www.gugudata.com/api/details/fetchcontent/llm.md

关键请求参数：

获取公众号文章封面

• 业务角色：公众号封面
• 调用阶段：内容抽取
• 接口地址：GET https://api.gugudata.com/news/wxarticlecover
• 产出用途：用于获取公众号文章封面。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/wxarticlecover；接口 Markdown https://www.gugudata.com/api/details/wxarticlecover/llm.md

关键请求参数：

文章抽取信息化 JSON

• 业务角色：文章结构化
• 调用阶段：内容抽取
• 接口地址：POST https://api.gugudata.com/ai/v1/articles/extract
• 产出用途：用于结构化提取文章信息。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 可参考的相关能力：从 HTML 提取文章内容
• 接口资料：详情页 https://www.gugudata.com/api/details/article-extract；接口 Markdown https://www.gugudata.com/api/details/article-extract/llm.md

关键请求参数：

文本多语言 AI 摘要

• 业务角色：文本摘要
• 调用阶段：内容整理
• 接口地址：POST https://api.gugudata.com/ai/text-summarize
• 产出用途：用于生成院校或专业内容摘要。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/summarize-text；接口 Markdown https://www.gugudata.com/api/details/summarize-text/llm.md

关键请求参数：

通用二维码生成

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

关键请求参数：

失败处理与恢复

• 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
• 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
• 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
• 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
• 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

• 高考内容必须区分官方数据、历史参考和模型预测。
• 文章抽取结果需要考虑版权和来源，不应当作授权内容。
• 录取概率和问答解释不能替代考试院或学校官方信息。

输出建议

• 输出内容稿时保留院校数据、专业数据、历史分数线和来源链接。
• 问答结果应标注所用年份、省份、批次和选科口径。
• 二维码输出应说明目标 URL 和投放前复核要求。

常见问题

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