# Ielts Buddy Question Research

> 在已绑定且具备 IELTS Buddy 后台题库权限的账号下，发现并调用只读题库数据接口；不定义题库研究或分析方法。

- Skill: `jobo16/ielts-buddy-question-research` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jobo16/ielts-buddy-question-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jobo16/ielts-buddy-question-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: Jobo16 (https://skillmd.com/u/jobo16)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jobo16/ielts-buddy-question-research

---


# IELTS Buddy 题库数据接口

本 Skill 只说明题库数据接口、授权和字段使用。它不规定研究方法、分析流程、结论形式或后续动作。

## 访问

使用普通 `bind`、`IELTS_BUDDY_TOKEN` 和 `/api/v1/agent`。先执行：

```sh
python3 scripts/ielts_buddy_api.py capabilities
```

仅当当前账号返回下列能力时才可调用；未返回即停止，不尝试使用数据库、Cookie、私有接口或普通刷题接口绕过权限。详情见[访问边界](references/access.md)。

## 接口

| 能力 | 数据 | 调用约束 |
| --- | --- | --- |
| `ielts_question_research_coverage` | 标签维度的 Part 与题目数量 | 可传 `subject`、`groupCodes`、`scope`。 |
| `ielts_question_research_list_parts` | Part 目录、科目、难度、来源更新时间、标签和题目数 | 使用返回的 `nextOffset` 翻页。 |
| `ielts_question_research_read_parts` | 指定 Part 的题干、材料、题型、标签、来源和可选答案解析 | 只传已确定的 `partIds`；不需要答案时设 `includeAnswers:false`。 |

```sh
python3 scripts/ielts_buddy_api.py call ielts_question_research_coverage --json '{"subject":"reading"}'
python3 scripts/ielts_buddy_api.py call ielts_question_research_list_parts --json '{"subject":"reading","limit":20,"offset":0}'
python3 scripts/ielts_buddy_api.py call ielts_question_research_read_parts --json '{"partIds":[123],"includeAnswers":false}'
```

## 边界

- 只读；不导入、修改、发布、隐藏或归档题库内容。
- 不返回做题记录、正确率或用户行为数据。
- `workflows/` 是独立的可选推荐层，不属于本 Skill 的接口契约。