这是 MusicLibrary 的 Python 语言绑定，提供了对网易云音乐、酷狗音乐等音乐平台 API 的 Python 接口访问。
pip install pymusiclibrary从源码安装需要先构建 wheel 包，详见下方 构建指南。
# 克隆仓库
git clone https://github.com/2061360308/MusicLibrary.git
cd MusicLibrary/src/python
# 安装依赖
pip install -r requirements.txt
# 按照 [构建指南](#-构建指南) 构建完成后安装
pip install dist/musiclibrary-*.whl所有 API 请求返回统一的 Response 对象，自动解析 JSON 响应字符串。
属性说明：
| 属性 | 类型 | 说明 |
|---|---|---|
status |
int | HTTP 状态码，200 表示成功，解析失败默认 500 |
headers |
dict | 响应头信息，解析失败默认空字典 |
body / data |
dict | 响应体数据，解析失败默认空字典 |
cookies |
str | 从 headers 获取的 Set-Cookie 值 |
from MusicLibrary.neteaseCloudMusicApi import NeteaseCloudMusicApi
ncm = NeteaseCloudMusicApi()
response = ncm.playlist_mylike()
# 检查状态码
if response.status == 200:
# 获取数据（body 和 data 等价）
songs = response.body.get('playlist', {}).get('tracks', [])
songs = response.data.get('playlist', {}).get('tracks', [])
# 获取 Cookie（登录接口返回）
cookies = response.cookies
# 查看完整响应（自动格式化打印）
print(response)错误处理：当响应解析失败时，Response 会自动使用默认值（status=500, headers={}, body={}），不会抛出异常。
from MusicLibrary.neteaseCloudMusicApi import NeteaseCloudMusicApi, NcmProcessEnv
# 创建 API 实例
ncm = NeteaseCloudMusicApi()
# 使用封装好的方法
response = ncm.playlist_mylike()
print(response)
# 获取歌曲详情
response = ncm.song_detail(ids="347230")
print(response)
# 搜索歌曲
response = ncm.search_default()
print(response)from MusicLibrary.kuGouMusicApi import KuGouMusicApi, Platform, KugouProcessEnv
# 创建 API 实例（使用轻量版平台）
kugou = KuGouMusicApi(KugouProcessEnv(platform=Platform.LITE))
# 获取新歌速递
response1 = kugou.top_song()
print(response1)
# 获取专辑详情
response2 = kugou.album_detail(id='10729818')
print(response2)网易云音乐 API 已完整封装为方法，直接调用即可。
示例方法：
login_cellphone()- 手机号登录playlist_mylike()- 获取用户歌单song_detail()- 获取歌曲详情search_default()- 搜索歌曲lyric()- 获取歌词artist_detail()- 获取艺术家详情album()- 获取专辑信息- 更多方法请查看
neteaseCloudMusicApi.py源码
酷狗音乐提供了封装好的方法，直接调用即可。
示例方法：
top_song()- 获取新歌速递album_detail()- 获取专辑详情search_default()- 搜索歌曲- 更多方法请查看
kuGouMusicApi.py源码
from MusicLibrary.kuGouMusicApi import Platform, KugouProcessEnv
# 支持的平台类型
kugou = KuGouMusicApi(KugouProcessEnv(platform=Platform.LITE)) # 概念版
kugou = KuGouMusicApi(KugouProcessEnv(platform=Platform.WEB)) # 普通版重要：KuGouMusicApi、NeteaseCloudMusicApi 等 API 对象不能跨线程使用。如果需要多线程访问，请为每个线程创建独立的实例。
from MusicLibrary.neteaseCloudMusicApi import NeteaseCloudMusicApi
# 错误示例 - 不要这样做！
api = NeteaseCloudMusicApi(None)
Thread(target=api.request, args=('/api/path', '{}')).start()
# 正确做法
def worker():
api = NeteaseCloudMusicApi()
return api.login_cellphone(phone="xxx", password="yyy")
Thread(target=worker).start()原始 Node.js 项目支持缓存功能，相同请求会返回缓存数据。当前 Python 绑定版本尚未实现缓存功能，请根据业务需求自行处理。
上游仓库已完成预编译，只需要从对方 Release 下载对应平台的预编译库即可。
# 1. 下载并配置预编译库
python setLibArch.py win64 # 或 win32、winarm
# 2. 设置环境变量（CMD）
set MUSICLIB_ARCH=win64
# 3. 构建 wheel
python -m build --wheelPowerShell 设置环境变量：
$env:MUSICLIB_ARCH="win64"
python -m build --wheel# 1. 下载并配置预编译库
python setLibArch.py linux64 # 或 linuxarm
# 2. 设置环境变量
export MUSICLIB_ARCH=linux64
# 3. 构建 wheel
python -m build --wheel# 1. 下载并配置预编译库
python setLibArch.py macos64 # 或 macosarm
# 2. 设置环境变量
export MUSICLIB_ARCH=macos64
# 3. 构建 wheel
python -m build --wheel| 架构参数 | 平台 | 说明 |
|---|---|---|
win64 |
Windows | 64 位 Windows |
win32 |
Windows | 32 位 Windows |
winarm |
Windows | ARM64 Windows |
linux64 |
Linux | x86_64 Linux |
linuxarm |
Linux | ARM64 Linux |
macos64 |
macOS | Intel 芯片 macOS |
macosarm |
macOS | Apple Silicon (M1/M2/M3) |
欢迎提交 Issue 和 Pull Request！
贡献指南：
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
本项目采用 MIT 许可证开源。详见 LICENSE 文件。