IELTS Buddy 题库数据接口
本 Skill 只说明题库数据接口、授权和字段使用。它不规定研究方法、分析流程、结论形式或后续动作。
访问
使用普通 bind、IELTS_BUDDY_TOKEN 和 /api/v1/agent。先执行:
python3 scripts/ielts_buddy_api.py capabilities
仅当当前账号返回下列能力时才可调用;未返回即停止,不尝试使用数据库、Cookie、私有接口或普通刷题接口绕过权限。详情见访问边界。
接口
| 能力 | 数据 | 调用约束 |
|---|---|---|
ielts_question_research_coverage |
标签维度的 Part 与题目数量 | 可传 subject、groupCodes、scope。 |
ielts_question_research_list_parts |
Part 目录、科目、难度、来源更新时间、标签和题目数 | 使用返回的 nextOffset 翻页。 |
ielts_question_research_read_parts |
指定 Part 的题干、材料、题型、标签、来源和可选答案解析 | 只传已确定的 partIds;不需要答案时设 includeAnswers:false。 |
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 的接口契约。