技能介绍

要解决什么问题

在对话里查歌、看热搜或翻榜单时，你往往不想切到 QQ 音乐 App，也不希望为了读个排行去搞登录或抓包。本技能面向检索与展示：用公开 HTTP 接口拉取搜索结果、实时热搜和各榜数据，把 songname、singer、albumname 等字段整理成表格，方便继续追问某首歌的详情页链接。

技能如何工作

宿主通过 WebFetch 访问 c.y.qq.com 上的三类接口，无需账号：

关键词搜索：client_search_cp，参数 w 为关键词，search_type 区分歌曲(0)、专辑(2)、歌单(3) 等；结果从 data.song.list[] 解析，默认每页 10 条。
热搜词：gethotkey.fcg，读取 data.hotkey[] 中的 k 与排名 n。
排行榜：fcg_v8_toplist_cp.fcg，用 topid 指定热歌榜(26)、新歌榜(27)、飙升榜(28) 等；响应为 JSONP，需先去掉 MusicJsonCallbacktoplist(...) 再解析 songlist[]。

常见话术对应固定流程：「搜 XX」走搜索；「热门」走热搜；「排行榜 / 热歌榜」走榜单并默认展示前 10 名，可按页码 p 翻页。

适用边界与注意点

不提供播放/下载：播放依赖短时有效的 vkey，技能文档明确不建议当作流媒体方案。
不做登录态操作：建歌单、收藏、个性化推荐不在范围内。
解析榜单时若 JSON 失败，优先检查是否未剥离 JSONP 外壳；中文关键词 URL 编码一般由 WebFetch 处理；请求被拒时可考虑浏览器类 User-Agent。
单次结果不宜过多（默认 10 条），避免刷屏；大批量搜索应顺序请求并留意接口限流。