QQ音乐助手
通过 Agent Gateway 调用 QQ 音乐开放平台接口，提供搜索、推荐、排行榜、歌单等能力。
支持的能力
| 能力 | 说明 | 用户示例 | 详细说明 |
|---|---|---|---|
| 搜索 | 搜索歌曲、专辑、歌单、MV、电台、歌手 | "帮我搜一下周杰伦" "搜晴天这首歌" | discover.md |
| 每日推荐 | 每日 30 首个性化推荐 | "今天推荐什么歌" | discover.md |
| 猜你喜欢 | 猜你喜欢电台 | "给我推荐一些可能喜欢的歌曲" | discover.md |
| AI 歌单 | AI 推荐歌单 | "给我推荐一些跑步歌单" | discover.md |
| 排行榜 | 查看各类音乐排行榜 | "看看排行榜" | charts.md |
| 歌单详情 | 查看歌单完整歌曲列表 | "看看这个歌单里有什么" | playlists.md |
| 听歌报告 | 按日/周/月聚合的听歌统计 | "今日听歌报告" "本周听了多少" | me.md |
| AI 解读 | 基于您的QQ音乐旅程进行解读，只有用户明确是解读操作才调用此接口 | "分析我的听歌风格" "我是一个什么样的听众" | assistant.md |
| 技能升级 | 检查 skill 是否有新版本，由用户决定是否升级 | "更新 QQ音乐 skill" "升级 QQ音乐技能" "检查 QQ音乐有没有新版本" | version.md |
调用任何接口前，必须先读取对应能力说明文件（如 discover.md、me.md），确认接口参数和字段含义后方可调用。禁止仅凭字段名猜测。
路由优先级（重要）
结构化接口优先，AI 解读兜底。 先判断用户意图是否命中前 7 项能力（搜索/每日推荐/猜你喜欢/AI 歌单/排行榜/歌单详情/听歌报告），命中则走对应接口；仅当用户明确要求"分析/解读/画像"（如"分析我的听歌风格""我是一个什么样的听众"）时才走 AI 解读。
常见误判场景：
- "推荐一些歌"、"给我推荐xx" → 走每日推荐/猜你喜欢/AI 歌单，不要走 AI 解读
- "今天听了什么"、"听歌报告" → 走
/me/report，不要走 AI 解读 - "搜一下xx" → 走
/discover/search，不要走 AI 解读
接口调用规范
统一入口
POST ${BaseUrl}{path}
BaseUrl默认https://a.y.qq.com{path}是具体的接口路径，如/discover/search、/discover/daily-mix等，详见各能力说明文件
鉴权
- Header：
Authorization: Bearer $QQMUSIC_API_KEY - API Key 格式
qmk-xxxxxxxx，与用户账号绑定，需要用户身份的接口会自动识别调用者 - 获取 API Key：https://y.qq.com/n/ryqq_v2/qqmusic_skills
- 鉴权依赖环境变量
$QQMUSIC_API_KEY
Key 初始化流程（首次使用或 Key 未设置时）：
- 先执行
echo $QQMUSIC_API_KEY检查是否已设置 - 已设置则直接使用，跳过后续步骤
- 未设置则主动询问用户提供 Key
- 用户提供后，检测当前 Shell 类型，将
export QQMUSIC_API_KEY="<API Key>"写入对应 profile：- bash →
~/.bashrc - zsh →
~/.zshrc - 写入前检查是否已有旧的 QQMUSIC_API_KEY 配置，有则替换
- bash →
- 写入后执行
source <profile文件>使其立即生效，然后继续后续调用
剩余内容仅限会员查看
「qqmusic」的完整方法论、话术模板与执行步骤都在下半部分。 开通会员即可解锁全部技能，并下载安装包直接接入 WorkBuddy。
- 全部技能完整正文
- 复制提示语
- 下载 .zip 安装包
- 新技能自动解锁
已有卡密？点此激活