前言¶

做音乐相关的 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