安装与使用咕咕数据 Agent Skills

安装 API Discovery Skill,按业务任务查找接口与流程,并选择使用 AppKey 或通过 MCP 授权执行查询。

查看 Markdown

核心步骤

  1. 在 Skills 页面选择客户端,复制安装命令。
  2. 在当前项目中安装并打开新会话,确认助手能找到咕咕数据 Skill。
  3. 描述业务任务,先核对推荐接口和必填参数,再按需调用。
本文目录

Skill 能帮你做什么

安装咕咕数据 API Discovery Skill 后,助手可以按任务查找合适的接口,阅读对应业务流程,核对参数和结果字段。例如,高考录取与志愿研究 介绍如何结合院校、历年分数与录取概率完成研究。

Skill 负责指导助手查阅资料。直接调用 API 使用产品 AppKey;希望助手在对话中调用工具时,另行 连接 MCP 并完成 OAuth 授权。调用仍受账号的接口权限与使用额度约束。

在项目中安装

打开 Skills 安装区,选择正在使用的客户端,复制命令。安装时选择 Project,将 Skill 放入当前项目。以下是 Codex 示例,需要 Node.js 22.20 或更新版本。

npx skills@1.8.1 add https://www.gugudata.com --skill gugudata-api-discovery --agent codex

也可以在同一页面展开“手动安装”,将 SKILL.md 保存到该客户端的项目目录。例如 Codex 使用 .agents/skills/,GitHub Copilot 使用 .github/skills/。每个目录下的完整文件路径以对应客户端面板为准。

验证安装并开始使用

在该项目中打开新会话。Codex 中输入 $ 并选择 gugudata-api-discovery,Claude Code 或 GitHub Copilot 中输入 /gugudata-api-discovery。其他客户端按安装面板说明选择或提及 Skill。你可以先让助手做一次资料查阅。

我想用 2025 年江苏物理类考生的分数,查北京大学的录取概率。
请先查阅咕咕数据的高考录取研究流程,列出接口文档和我还需要提供的参数。

核对助手给出的接口链接、年份和必填参数。如果只想让助手生成接入代码,继续阅读 Coding Agent 接入指南。如果需要查询实际数据,请在授权后的 MCP 客户端使用对应工具,或按 API 快速开始 从后端调用。

找不到 Skill 或接口时

找不到 Skill 时,先确认会话打开的是安装时的项目,并检查客户端的 Skill 目录中是否有 gugudata-api-discovery/SKILL.md。已经找到 Skill、但找不到可调用工具时,检查 MCP 连接、授权账号和接口权益,详见 MCP 客户端配置。