前言¶
自學或備考時，常見做法是在瀏覽器裏反覆搜關鍵詞、點開多門課比目錄和評價，再自己記筆記。對話式 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
