# 安装与使用咕咕数据 Agent Skills

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

## 核心步骤

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

## Skill 能帮你做什么

安装咕咕数据 API Discovery Skill 后，助手可以按任务查找合适的接口，阅读对应业务流程，核对参数和结果字段。例如，[高考录取与志愿研究](https://www.gugudata.com/skills/gaokao-admission-research) 介绍如何结合院校、历年分数与录取概率完成研究。

Skill 负责指导助手查阅资料。直接调用 API 使用产品 AppKey；希望助手在对话中调用工具时，另行 [连接 MCP 并完成 OAuth 授权](https://www.gugudata.com/developers/mcp)。调用仍受账号的接口权限与使用额度约束。

## 在项目中安装

打开 [Skills 安装区](https://www.gugudata.com/skills#skill-install)，选择正在使用的客户端，复制命令。安装时选择 Project，将 Skill 放入当前项目。以下是 Codex 示例，需要 Node.js 22.20 或更新版本。

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

也可以在同一页面展开“手动安装”，将 [SKILL.md](https://www.gugudata.com/.well-known/agent-skills/gugudata-api-discovery/SKILL.md) 保存到该客户端的项目目录。例如 Codex 使用 `.agents/skills/`，GitHub Copilot 使用 `.github/skills/`。每个目录下的完整文件路径以对应客户端面板为准。

## 验证安装并开始使用

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

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

核对助手给出的接口链接、年份和必填参数。如果只想让助手生成接入代码，继续阅读 [Coding Agent 接入指南](https://www.gugudata.com/developers/ai-integration)。如果需要查询实际数据，请在授权后的 MCP 客户端使用对应工具，或按 [API 快速开始](https://www.gugudata.com/developers/getting-started) 从后端调用。

## 找不到 Skill 或接口时

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