高考志愿与教育数据 Skill

面向高考志愿填报、院校库、专业库、分数线、招生计划和录取概率分析的公开 API 组合。

业务场景

用于高考志愿填报、教育数据平台、院校库查询、专业库查询、招生计划分析和录取概率解释。适合把院校、专业、招生计划、分数线、一分一段、院校评分和智能问答组合成完整的志愿填报数据链路。

• 数据范围：覆盖院校基础信息、专业信息、招生计划、院校录取线、专业录取线、省控线、一分一段、模型预测、院校评分、高考问答以及部分职教、海外院校和测评扩展数据。
• 关键数据维度：院校维度：学校名称、地区、层次、类型、办学属性、院校代码和综合评分。；专业维度：专业名称、专业门类、院校开设情况和专业录取参考。；招生维度：年份、省份、批次、科类、选科、计划人数、招生代码和专业组信息。；录取维度：最低分、最低位次、省控线、一分一段区间、预测概率和历史趋势。

何时使用

• 按省份、年份、批次、科类或选科条件筛选院校和专业。
• 对比分数线、位次、招生计划和录取概率，支撑冲稳保排序。
• 为院校详情页、专业详情页、志愿推荐页和问答助手提供数据依据。

不适用场景

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

用户需要提供的信息

• 考生省份、目标年份、科类或选科、批次、分数和位次。
• 目标院校、院校所在地、专业名称、院校层次或冲稳保偏好。
• 需要对比的历史年份范围，以及是否需要录取概率、院校评分或问答解释。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先查询院校、专业和省份基础数据。
2. 再按年份、省份、批次、选科或科类查询分数线与招生计划。
3. 需要排序或推荐时，结合一分一段、录取概率和高校评分接口做结果解释。

参数传递关系

• 先用院校基础信息接口按 keywords、地区、院校类型或层次查询院校，并保留返回的 SchoolUUID、院校名称、院校所在地和院校代码。
• SchoolUUID 可继续传给招生计划、分数线、录取概率或院校评分相关接口；院校名称可作为模糊查询和展示字段。
• year、provinceName、subjectSelection、batchName 必须在招生计划、分数线、一分一段和预测接口之间保持同一口径。
• 用户提供 score 后，先用一分一段接口换算或校验 rank；如果用户已经提供位次，应优先使用真实位次。
• 专业偏好先用专业库或招生计划明细确认标准专业名称，再传给专业分数线或专业级录取预测。

典型任务模板

• 院校推荐：输入省份、年份、科类/选科、批次、分数和位次；输出冲稳保分组、历史分数线、招生计划和录取概率说明。
• 院校详情：输入院校名称或 SchoolUUID；输出院校基础信息、开设专业、招生计划、近年录取线和院校评分。
• 专业对比：输入专业名称、目标省份、年份和批次；输出开设院校、计划人数、专业录取线和风险提示。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 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/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

关键请求参数：

历年高考高校录取分数线

• 业务角色：院校录取线
• 调用阶段：录取参考
• 接口地址：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/ceemajorline
• 产出用途：用于查询高校专业历年录取分数线，适合做专业维度对比。
• 参数来源：year 使用考生关注的招生年份、考试年份或历史对比年份；分页参数由调用方控制，用于分批读取结果；SchoolUUID 来自院校基础信息查询结果，也可以由用户指定院校后查询获得；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询
• 可参考的相关能力：历年高考专业录取分数线-查询参数枚举
• 接口资料：详情页 https://www.gugudata.com/api/details/ceemajorline；接口 Markdown https://www.gugudata.com/api/details/ceemajorline/llm.md

关键请求参数：

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

历年高考省录取分数线

• 业务角色：省控线
• 调用阶段：录取参考
• 接口地址：GET https://api.gugudata.com/metadata/ceeprovince
• 产出用途：用于查询省级批次控制线，辅助判断批次和填报范围。
• 参数来源：关键词由用户输入或从上一轮内容抽取结果中生成；year 使用考生关注的招生年份、考试年份或历史对比年份
• 接口资料：详情页 https://www.gugudata.com/api/details/ceeprovince；接口 Markdown https://www.gugudata.com/api/details/ceeprovince/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/college-score
• 产出用途：用于实时分析高校综合评分，辅助院校推荐。
• 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
• 接口资料：详情页 https://www.gugudata.com/api/details/college-score；接口 Markdown https://www.gugudata.com/api/details/college-score/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

关键请求参数：

职教高考及高职分类招生控制线

• 业务角色：职教高考控制线
• 调用阶段：扩展场景
• 接口地址：GET https://api.gugudata.com/metadata/vocational-control-lines
• 产出用途：用于职教高考和高职分类招生控制线查询。
• 参数来源：year 使用考生关注的招生年份、考试年份或历史对比年份；省份参数需要区分考生所在省份、招生省份和院校所在地；分页参数由调用方控制，用于分批读取结果；科类或选科来自用户所在省份当年的可选枚举
• 可参考的相关能力：职教高考及高职分类招生控制线-查询参数枚举
• 接口资料：详情页 https://www.gugudata.com/api/details/vocationalcontrollines；接口 Markdown https://www.gugudata.com/api/details/vocationalcontrollines/llm.md

关键请求参数：

全国中学基础信息

• 业务角色：中学基础信息
• 调用阶段：扩展场景
• 接口地址：GET https://api.gugudata.com/metadata/middle-school
• 产出用途：用于中学基础数据查询。
• 参数来源：分页参数由调用方控制，用于分批读取结果；院校名称、关键词或地区由用户输入，必要时先用院校库做模糊查询；省份参数需要区分考生所在省份、招生省份和院校所在地；科类或选科来自用户所在省份当年的可选枚举
• 接口资料：详情页 https://www.gugudata.com/api/details/middleschool；接口 Markdown https://www.gugudata.com/api/details/middleschool/llm.md

关键请求参数：

全球大学基础信息数据

• 业务角色：全球大学基础信息
• 调用阶段：扩展场景
• 接口地址：GET https://api.gugudata.com/college/global-university
• 产出用途：用于海外院校信息展示。
• 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；国家地区来自用户输入、国家地区接口或业务目标市场；分页参数由调用方控制，用于分批读取结果
• 可参考的相关能力：学校专业明细分页查询
• 接口资料：详情页 https://www.gugudata.com/api/details/global-university；接口 Markdown https://www.gugudata.com/api/details/global-university/llm.md

关键请求参数：

全球 QS 世界大学排名数据

• 业务角色：全球大学排名
• 调用阶段：扩展场景
• 接口地址：GET https://api.gugudata.com/metadata/global-university-ranking
• 产出用途：用于展示 QS 世界大学排名。
• 参数来源：分页参数由调用方控制，用于分批读取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/global-university-ranking；接口 Markdown https://www.gugudata.com/api/details/global-university-ranking/llm.md

关键请求参数：

职业与发展心理测评问卷

• 业务角色：职业发展测评
• 调用阶段：扩展场景
• 接口地址：GET https://api.gugudata.com/v1/psychology/questionnaires
• 产出用途：用于职业与发展心理测评问卷场景。
• 参数来源：关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
• 可参考的相关能力：获取问卷详情、提交测试答案、查询测试结果、用户测试历史
• 接口资料：详情页 https://www.gugudata.com/api/details/psychology-questionnaires；接口 Markdown https://www.gugudata.com/api/details/psychology-questionnaires/llm.md

关键请求参数：

考题相似度 AI 分析

• 业务角色：考题相似度
• 调用阶段：扩展场景
• 接口地址：POST https://api.gugudata.com/education/exam-question-similarity
• 产出用途：用于考题相似度 AI 分析。
• 参数来源：科类或选科来自用户所在省份当年的可选枚举；文本内容来自用户输入、网页正文抽取或文档识别结果；文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/exam-question-similarity；接口 Markdown https://www.gugudata.com/api/details/exam-question-similarity/llm.md

关键请求参数：

失败处理与恢复

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

数据校验与使用边界

• 优先校验年份、省份、批次、科类或选科条件是否一致。
• 分数线和位次只能作为志愿填报参考，高风险决策必须结合考试院和学校官方发布信息。
• 模型预测和院校评分适合辅助排序，不应作为唯一录取判断依据。

输出建议

• 输出院校推荐时，按冲、稳、保或概率区间分组。
• 解释结果时同时给出历史分数、位次、招生计划和接口详情页来源。
• 对缺失年份、政策变化、专业组变化和特殊招生类型明确标注限制。

常见问题

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