# music · 音乐搜索

按关键词搜歌、按 ID 查歌词（数据来自网易云音乐公开接口）。

## 工具

| 工具 | 说明 |
|---|---|
| `music_search` | 按关键词搜歌，返回歌曲列表（含歌曲 ID） |
| `music_lyrics` | 按歌曲 ID 取歌词 |

典型两段式用法：先 `music_search` 拿 ID，再 `music_lyrics` 取词。

## 实现要点

- 请求打的是 `https://music.163.com/api/...`，并固定带上 `Referer: https://music.163.com/` ——
  该接口对缺少来源头的请求会拒绝。
- 是**只读**插件：不下载音频、不写本地文件，因此没有需要清理的副作用。

## 已知边界

- 依赖第三方（网易云）公开接口，其可用性与返回结构不受本插件控制；
  接口变动时可能返回空列表，而不是报错。
- 仅覆盖"搜索 + 歌词"，不含播放地址解析。

## 构建

```bash
hmapdev build
```