openclaw/mooc-course-search

MOOC Course Search

用于搜索 MOOC 课程，并基于用户目标输出可执行的选课建议。

When to Use This Skill

Primary Triggers（优先触发）

• 用户明确要找某主题课程（如高等数学、机器学习、考研相关）
• 用户要求比较多门课程并给出推荐结论
• 用户关心课程详情、学习路径、认证成绩或证书信息
• 用户希望按目标筛选最适合课程（考试、就业、兴趣、转专业）

Automatic Trigger Keywords

• mooc, 慕课, 中国大学MOOC, 课程推荐, 课程对比
• 证书, 认证成绩, 考核方式, 学习收益
• 高等数学, 机器学习, 人工智能,计算机基础, 考研辅导

When NOT to Use This Skill

• 用户仅需通用网页信息检索，且不涉及课程选择
• 用户问题与学习课程无关（如商品比价、新闻热点）

Platform Notes

• 平台：中国大学 MOOC（网易与教育部爱课程网联合推出）
• 特色：名校名师课程丰富，支持免费学习与认证体系
• 学科覆盖：基础科学、人文社科、工程技术、经管法学、农林医药等

Execution Guidelines

Request Endpoint

默认使用以下接口进行课程搜索：

curl --location "https://mcp.study.youdao.com/public/mm-course/course/search" \
  --header "Content-Type: application/json" \
  --data '{
    "queryList": ["高等数学", "微积分", "考研数学"]
  }'

课程详情查询接口（仅在用户明确想进一步了解某门课程时调用，入参来自上一步搜索结果中的 courseId 和 termId）：

curl --location "https://mcp.study.youdao.com/public/mm-course/course/detail" \
  --header "Content-Type: application/json" \
  --data '{
    "courseId": 1207108809,
    "termId": 1472362510
  }'

Runtime Rules

• API 调用应等待服务端完成并返回结果后再继续处理
• 搜索接口请求体使用 queryList
• 根据用户提问自动生成搜索词列表，默认约 3 个，最多不超过 5 个
• queryList 内搜索词应去重，并覆盖同义词/近义表达（如“机器学习/机器学习入门”）
• 仅当用户表达“想进一步了解某门课”时调用课程详情接口
• 详情接口请求体固定使用上一步搜索结果：courseId、termId
• 当搜索结果不足时，需自动改写检索词再检索 1 次
• 结果为空时，明确告知并给出下一轮检索建议

Timeout & Retry

| Operation | Expected Time | Recommended Timeout | Notes | | ------------------------------------------------- | ------------- | ------------------- | ------ | | Course Search (/public/mm-course/course/search) | 5-20s | 30s | 常规课程检索 | | Course Detail (/public/mm-course/course/detail) | 5-15s | 30s | 课程详情补全 |

重试策略（仅瞬时错误）：

1. 第 1 次重试：等待 2 秒
2. 第 2 次重试：等待 4 秒
3. 第 3 次重试：等待 8 秒
4. 最多 3 次，超出后返回失败原因与建议

不重试场景：

• 参数错误或请求体不合法
• 认证失败（访问凭证缺失、无效或已过期）

Endpoint Configuration

• Course Search: https://mcp.study.youdao.com/public/mm-course/course/search
• Course Detail: https://mcp.study.youdao.com/public/mm-course/course/detail

Output Requirements

拿到检索结果后，必须结合用户意图进行二次分析，输出以下内容：

1. 最推荐课程（1-3 门）及推荐理由
2. 每门课程关键信息摘要（课程定位、适合人群、学习收益）
3. 若结果不足，给出更精确的下一轮检索词
4. 若用户关注证书，补充认证与考核相关提示
5. 仅在用户要求进一步了解单门课程时，调用详情接口并补充课程详细信息（如开课院校、授课教师、章节/进度安排、考核与证书说明）
6. 输出时可展示实际使用的 queryList（3-5 个）以便用户理解检索覆盖范围

Interaction Strategy

• 用户目标不清晰时，先澄清学习目标（考试/就业/兴趣）
• 用户强调效率时，优先推荐结构清晰、评价稳定的入门课
• 用户要求进阶时，按“入门 -> 进阶 -> 实战”给出组合建议
• 用户未提出“进一步了解某门课程”时，不主动调用详情接口

Error Handling

推荐按 HTTP 状态码处理：

• 200: 正常解析并输出推荐
• 400: 提示用户优化查询词或参数
• 404: 提示资源不存在并建议更换关键词
• 500/503/504: 按重试策略处理，失败后给出降级建议

Security Constraints

• 不在回复中明文输出长期有效访问凭证
• 不将访问凭证写入仓库文件或日志
• 仅展示与用户问题相关的最小必要信息