前言¶

自学或备考时，常见做法是在浏览器里反复搜关键词、点开多门课比目录和评价，再自己记笔记。对话式 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、课程推荐、课程对比、证书、高等数学、机器学习等。

不应使用：仅需与学习无关的通用检索（如商品比价、新闻热点），或问题与选课无关时。

检索与详情¶

1. 课程搜索：POST https://mcp.study.youdao.com/public/mm-course/course/search，请求体使用 queryList（字符串数组，默认约 3 个词，最多 5 个，去重并覆盖同义词）。
2. 课程详情：POST https://mcp.study.youdao.com/public/mm-course/course/detail，仅在用户明确想进一步了解某门课时调用；courseId、termId 必须来自上一步搜索结果。

运行时规则包括：等待接口返回后再继续；结果不足时改写检索词再搜一次；结果为空时说明并给出下一轮检索建议；用户未要求深入了解单门课时，不主动调详情接口。

输出与交互¶

拿到检索结果后，Skill 要求结合用户意图二次分析，输出例如：

• 最推荐 1–3 门课及理由；
• 每门课的定位、适合人群、学习收益摘要；
• 可选展示实际使用的 queryList；
• 用户关注证书时补充认证与考核提示；
• 调用详情后补充院校、教师、章节进度、考核与证书说明。

目标不清晰时先澄清（考试 / 就业 / 兴趣）；强调效率时优先结构清晰、评价稳定的入门课；要求进阶时可按「入门 → 进阶 → 实战」组合建议。

超时、重试与错误¶

瞬时错误可重试最多 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