Web 服务

Web 服务将 QQMusicApi 暴露为 HTTP API。

1. 安装

git clone https://github.com/luren-dc/QQMusicApi
cd QQMusicApi
uv sync --group web

可使用环境变量或者编辑web/config.toml 来配置服务参数

uv run python web/run.py

打开 http://localhost:8000/docs 可以查看所有可用接口。

需要登录凭证的接口通过 Cookie 传递 QQ 音乐登录信息：

musicid 与 musickey 必须同时提供；如果未携带任何 Cookie，接口将以未登录状态调用。

所有接口均返回统一的 JSON 结构：

{
  "code": 0,
  "msg": "ok",
  "data": { ... }
}

curl "http://localhost:8000/search/search_by_type?keyword=周杰伦&search_type=song&num=5"

curl "http://localhost:8000/song/123456/detail"

curl "http://localhost:8000/song/123456/lyric?trans=true"