前言¶
自学或备考时，常见做法是在浏览器里反复搜关键词、点开多门课比目录和评价，再自己记笔记。对话式 Agent 能帮你整理需求，但若没有固定检索与输出规范，仍可能泛泛推荐网页链接，难以落到「哪几门课、为什么选」。
下面介绍 SkillHub 上的社区 Skill「慕课资源搜索与推荐」（坐标 @user_ab548812/mooc-course-search，当前版本 1.0.4）。它用通用 SKILL.md 约定触发条件、调用中国大学 MOOC 相关公开接口的方式，以及如何把搜索结果整理成可执行的选课建议；SkillHub 标注 requires_api_key=false，安装包内示例请求也未要求单独配置 API Key。
这是什么¶
慕课资源搜索与推荐 面向「找课、比课、按学习目标筛课」场景：Agent 根据用户意图生成多词检索列表，调用课程搜索接口拿到候选，再结合目标输出 1–3 门推荐及摘要；仅在用户明确表示要了解某一门课时，才用搜索结果里的 courseId、termId 拉取详情。
- 维护与来源：SkillHub 社区发布，发布者
user_ab548812，分类education，来源community。 - 平台范围：Skill 内说明聚焦 中国大学 MOOC（网易与教育部爱课程网联合推出），覆盖基础科学、人文社科、工程技术等学科；不涉及通用网页爬虫或视频下载。
SkillHub 页面：https://www.skillhub.cn/skills/user_ab548812/mooc-course-search
技能 API 入口：https://api.skillhub.cn/user_ab548812/mooc-course-search
核心功能¶
以下能力均来自该 Skill 的 SKILL.md / README.md 说明，经 skillhub install 安装包核对。
触发与边界¶
适合启用（优先触发）：
- 用户要找某主题课程（如高等数学、机器学习、考研相关）。
- 用户要求比较多门课并给出推荐结论。
- 用户关心课程详情、学习路径、认证成绩或证书。
- 用户希望按目标筛课（考试、就业、兴趣、转专业）。
关键词示例：mooc、慕课、中国大学 MOOC、课程推荐、课程对比、证书、高等数学、机器学习等。
不应使用：仅需与学习无关的通用检索（如商品比价、新闻热点），或问题与选课无关时。
检索与详情¶
- 课程搜索：
POST https://mcp.study.youdao.com/public/mm-course/course/search，请求体使用queryList（字符串数组，默认约 3 个词，最多 5 个，去重并覆盖同义词）。 - 课程详情：
POST https://mcp.study.youdao.com/public/mm-course/course/detail，仅在用户明确想进一步了解某门课时调用；courseId、termId必须来自上一步搜索结果。
运行时规则包括：等待接口返回后再继续；结果不足时改写检索词再搜一次；结果为空时说明并给出下一轮检索建议；用户未要求深入了解单门课时，不主动调详情接口。
输出与交互¶
拿到检索结果后，Skill 要求结合用户意图二次分析，输出例如：
- 最推荐 1–3 门课及理由；
- 每门课的定位、适合人群、学习收益摘要；
- 可选展示实际使用的
queryList； - 用户关注证书时补充认证与考核提示；
- 调用详情后补充院校、教师、章节进度、考核与证书说明。
目标不清晰时先澄清（考试 / 就业 / 兴趣）；强调效率时优先结构清晰、评价稳定的入门课；要求进阶时可按「入门 → 进阶 → 实战」组合建议。
超时、重试与错误¶
| 操作 | 预期耗时 | 建议超时 |
|---|---|---|
| 课程搜索 | 5–20s | 30s |
| 课程详情 | 5–15s | 30s |
瞬时错误可重试最多 3 次（间隔 2s、4s、8s）；参数错误、请求体不合法或认证失败不重试。HTTP 400/404/500/503/504 按 Skill 中的状态码指引向用户说明或降级。
安装与启用¶
方式一：让 Agent 按 SkillHub 文档安装¶
SkillHub 页面给出的提示为：根据 SkillHub 安装说明 安装 @user_ab548812/mooc-course-search。
方式二：SkillHub CLI¶
先确认本机已安装 skillhub（安装脚本见上述 skillhub.md）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/（完整列表见 skillhub.md）。
command -v skillhub && skillhub --version
skillhub install mooc-course-search --namespace user_ab548812 --dir ~/.cursor/skills/
搜索索引中的安装命令为：
skillhub install mooc-course-search --namespace user_ab548812
安装后按你所用客户端要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
启用 Skill 后，用自然语言描述学习目标即可；Agent 应按规范自动组 queryList 并调用接口。下面两段 curl 与包内示例一致，便于本地核对接口是否可达。
课程搜索（根据用户问题生成 queryList，示例为数学相关）：
curl --location "https://mcp.study.youdao.com/public/mm-course/course/search" \
--header "Content-Type: application/json" \
--data '{
"queryList": ["高等数学", "微积分", "考研数学"]
}'
课程详情（仅在用户要进一步了解某门课时使用；ID 须来自搜索结果）：
curl --location "https://mcp.study.youdao.com/public/mm-course/course/detail" \
--header "Content-Type: application/json" \
--data '{
"courseId": 1207108809,
"termId": 1472362510
}'
对话侧示例意图（非固定话术，仅说明触发方式）：
- 「我想系统学机器学习入门，在中国大学 MOOC 上推荐两三门课并说明区别。」
- 「这几门里哪门更适合考研数学？如果选定一门，把证书和考核方式说清楚。」
适用场景与注意¶
适合谁
- 在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端做学习规划、选课对比的开发者或自学者。
- 希望 Agent 输出结构化推荐，而不是只罗列搜索链接的团队。
限制与注意
- 数据与接口依赖
mcp.study.youdao.com公开服务，延迟与可用性以实际网络为准；Skill 建议搜索/详情各 30s 超时。 - Skill 为社区作品（
official: false），与平台官方文档无绑定；接口字段或行为变更时需自行关注发布者更新。 - SkillHub 抓取统计（截至资料核对）：评分 100000，下载 1390，安装 3；与页面展示可能随时间变化。
- 安全约束：不在回复或仓库中明文输出长期凭证；仅展示与问题相关的最小信息。
结尾¶
慕课资源搜索与推荐 把中国大学 MOOC 的搜索、可选详情与选课输出格式写进 Skill，让 Agent 在「找课、比课、谈证书」类对话里有可复现的步骤。需要安装或查看元数据时，以 SkillHub 为准：
- https://www.skillhub.cn/skills/user_ab548812/mooc-course-search
- https://api.skillhub.cn/user_ab548812/mooc-course-search
