前言¶

做音樂相關的 Agent 或聊天機器人時，常見需求是讓用戶能搜歌、看熱榜、拿到推薦。自己去接 QQ 音樂的接口要處理鑑權、解析、曲庫對齊這些瑣事。下面介紹的這個 Skill 把這類查詢封裝成一條指令，Agent 按 SKILL.md 約定觸發即可。

這是什麼¶

QQ音樂搜索（座標 @user_f446f091/music-search-v2）是一個社區來源的 Agent Skill，版本 1.0.0，由 user_f446f091 發佈，歸類在 life-service。它把 QQ 音樂的歌曲搜索、熱搜、榜單查詢能力打包成通用 SKILL.md 格式，供 Cursor、Claude Code 等支持該格式的 Agent 直接調用。

官方地址：https://www.skillhub.cn/skills/user_f446f091/music-search-v2

當前頁面數據：評分 100000，下載 791，安裝 0。標籤 requires_api_key=false，即不需要配置 API Key。

核心功能¶

按官方簡介，該 Skill 在用戶想搜歌、找流行音樂、瀏覽排行榜或獲取音樂推薦時觸發，已聲明的能力包括：

1、關鍵詞搜索：按歌名、歌手等關鍵詞搜歌曲；
2、熱搜詞：獲取 QQ 音樂當前的熱門搜索詞；
3、排行榜：瀏覽榜單、查看排名；
4、流行音樂與推薦：找 trending music、獲取音樂推薦。

四項能力都指向 QQ 音樂（QQ Music）站內數據。除功能說明外，官方資料未提供更多接口字段或參數細節，實際參數以安裝後的 SKILL.md 爲準。

安裝與啓用¶

官方資料中未提供安裝命令、目錄路徑或配置項。安裝方式請以 SkillHub 官方頁面爲準，訪問：

https://www.skillhub.cn/skills/user_f446f091/music-search-v2

由於該 Skill 使用通用 SKILL.md 格式，安裝後在支持該格式的 Agent 中按座標調用即可啓用。標籤 requires_api_key=false 表示啓用前不需要準備密鑰類配置。

典型用法¶

官方簡介中沒有給出可復現的調用示例。結合其聲明的能力，典型觸發場景是：

1、用戶說「幫我找一首周杰倫的歌」——觸發關鍵詞搜索；
2、用戶說「最近大家都在搜什麼」——觸發熱搜詞查詢；
3、用戶說「現在歌榜上有什麼」——觸發排行榜瀏覽；
4、用戶說「給我推薦點音樂」——觸發推薦或流行音樂查詢。

具體的輸入格式和返回字段，需要安裝後閱讀 SKILL.md 確認。

適用場景與注意¶

適合：需要在對話或工具調用里加入 QQ 音樂查詢的 Agent 開發者，例如音樂問答機器人、歌單推薦助手。

注意：

1、數據來源是 QQ 音樂，曲庫覆蓋和榜單口徑取決於 QQ 音樂站內規則；
2、官方頁面未給出接口穩定性與更新頻率說明，生產環境使用前建議先自行驗證；
3、頁面顯示安裝量爲 0，屬於較新的 Skill，生態反饋暫時沒有；
4、安裝命令與配置細節以官方頁面爲準，本文未從資料中核實到，不做推斷。

結尾¶

QQ音樂搜索的價值在於把 QQ 音樂的搜索、熱搜、榜單、推薦四類查詢收進一個 SKILL.md，免去開發者自己對接和解析的成本。需要了解安裝方式和具體用法，請訪問官方頁面：https://www.skillhub.cn/skills/user_f446f091/music-search-v2