Skip to content

2061360308/NeteaseCloudMusic_PythonSDK

Repository files navigation

MusicLibrary 语言绑定

cover

Python Version Dart Flutter License Platform

这是 MusicLibrary 的多语言绑定项目。MusicLibrary 通过「JavaScript → C → 多语言」架构,将网易云、酷狗等音乐平台 API 统一封装:用 JavaScript/Node.js 实现 API 逻辑,经 Webpack 打包后,由 QuickJS 引擎执行并封装为 C 接口,最终分发到 Python、Dart 等多种语言。

💡 提示:本项目的多平台预编译库资源、Node.js 源项目详情请查看 MusicLibrary 主仓库 的 Release 和 README 文档。

🌟 如果觉得这个项目对你有帮助,欢迎给主仓库点个 Star!也欢迎大家贡献新的语言绑定,一起让这个项目支持更多编程语言。祝大家用得开心!

🌍 支持的语言

语言 状态 使用方式 用法介绍
Python 网易云: ✅ 已支持
酷狗音乐:✅ 已支持
pip install pymusiclibrary README
Dart 网易云: ✅ 已支持
酷狗音乐:✅ 已支持
pubspec.yaml 添加依赖 README

🌟 特性

  • 统一接口:网易云、酷狗等多个音乐平台使用相同的调用方式
  • 🚀 高性能:基于 QuickJS 引擎,执行速度快,内存占用低
  • 🚀 超轻量:基于 C 语言预编译库,大小只有2Mb左右
  • 🌐 跨语言:支持 Python、Dart 等多种编程语言
  • 💪 功能丰富:支持 100+ API 接口,涵盖登录、搜索、播放、评论等完整功能
  • 🔒 开源免费:MIT 许可证,可自由使用和修改

⚠️ 免责声明

  1. 本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为及非法用途!
  2. 使用本项目的过程中可能会产生版权数据。对于这些版权数据,本项目不拥有它们的所有权。为了避免侵权,使用者务必在 24 小时内清除使用本项目的过程中所产 生的版权数据。
  3. 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害(包括但不限于因商誉损失、停 工、计算机故障或故障引起的损害赔偿,或任何及所有其他商业损害或损失)由使用者负责。
  4. 禁止在违反当地法律法规的情况下使用本项目。 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担,本 项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。
  5. 音乐平台不易,请尊重版权,支持正版。
  6. 本项目仅用于对技术可行性的探索及研究,不接受任何商业(包括但不限于广告等)合作及捐赠。
  7. 如果官方音乐平台觉得本项目不妥,可联系本项目更改或移除。

⚡ 注意事项

  • 线程安全性: KuGouMusicApi,NeteaseCloudMusicApi等其他接口对象 均不能跨线程使用,如果需要请为每个线程创建实例。
  • 缓存问题:原始Node项目是有缓存功能的,相同请求重复请求会直接返回缓存数据,但是在当前项目中,还没有实现缓存功能。

✨ 特性

只因项目是为了简单学习使用,加上作者精力有限,所以无法逐次测试检查下方所有接口。如果发现有误,欢迎 提出 issue 或者 Pr 指正

序号 KuGouMusic NeteaseCloudMusic
1 登录 登录
2 刷新登录 刷新登录
3 发送验证码 发送验证码
4 dfid 获取 校验验证码
5 获取用户额外信息 注册(修改密码)
6 获取用户 vip 信息 获取用户信息 , 歌单,收藏,mv, dj 数量
7 获取用户歌单 获取用户歌单
8 获取用户关注歌手 获取用户电台
9 获取用户听歌历史排行 获取用户关注列表
10 获取用户最近听歌历史 获取用户粉丝列表
11 获取继续播放信息 获取用户动态
12 收藏歌单/新建歌单 获取用户播放记录
13 取消收藏歌单/删除歌单 获取精品歌单
14 对歌单添加歌曲 获取歌单详情
15 对歌单删除歌曲 搜索
16 新碟上架 搜索建议
17 专辑信息 获取歌词
18 专辑详情 歌曲评论
19 专辑音乐列表 收藏单曲到歌单
20 获取音乐 URL 专辑评论
21 获取歌曲高潮部分 歌单评论
22 搜索 mv 评论
23 默认搜索关键词 电台节目评论
24 综合搜索 banner
25 热搜列表 获取歌曲详情
26 搜索建议 获取专辑内容
27 歌词搜索 获取歌手单曲
28 获取歌词 获取歌手 mv
29 歌单分类 获取歌手专辑
30 歌单 获取歌手描述
31 主题歌单 获取相似歌手
32 音效歌单 获取相似歌单
33 获取歌单详情 相似 mv
34 获取歌单所有歌曲 获取相似音乐
35 获取歌单所有歌曲(新版) 获取最近 5 个听了这首歌的用户
36 相似歌单 获取每日推荐歌单
37 获取主题歌单所有歌曲 获取每日推荐歌曲
38 获取主题音乐 私人 FM
39 获取主题音乐详情 签到
40 歌曲推荐 喜欢音乐
41 获取歌手和专辑图片 垃圾桶
42 获取歌手图片 歌单 ( 网友精选碟 )
43 获取音乐相关信息 新碟上架
44 获取更多音乐版本 热门歌手
45 获取音乐伴奏信息 最新 mv
46 获取音乐 k 歌数量 推荐 mv
47 获取音乐详情 推荐歌单
48 获取音乐专辑/歌手信息 推荐新音乐
49 私人 FM 推荐电台
50 banner 推荐节目
51 乐库 banner 独家放送
52 乐库电台 mv 排行
53 乐库 获取 mv 数据
54 电台 - 推荐 播放 mv/视频
55 电台 排行榜
56 电台 - 图片 歌手榜
57 电台 - 音乐列表 云盘
58 编辑精选 电台 - 推荐
59 编辑精选数据 电台 - 分类
60 编辑精选歌单 电台 - 分类推荐
61 编辑精选专区 电台 - 订阅
62 编辑精选专区详情 电台 - 详情
63 领取 VIP 电台 - 节目
64 获取歌手列表 给评论点赞
65 获取歌手详情 获取动态列表
66 获取歌手专辑 热搜列表(简略)
67 获取歌手单曲 发送私信
68 获取歌手 MV 发送私信歌单
69 关注歌手 新建歌单
70 取消关注歌手 收藏/取消收藏歌单
71 获取关注歌手新歌 歌单分类
72 获取视频 url 收藏的歌手列表
73 获取歌曲 MV 订阅的电台列表
74 获取视频相关信息 相关歌单
75 获取视频详情 付费精选接口
76 新歌速递 音乐是否可用检查接口
77 场景音乐列表 登录状态
78 场景音乐详情 获取视频播放地址
79 获取场景音乐讨论区 发送/删除评论
80 获取场景音乐模块 Tag 热门评论
81 获取场景音乐歌单列表 视频评论
82 获取场景音乐视频列表 退出登录
83 获取场景音乐音乐列表 所有榜单
84 每日推荐 所有榜单内容摘要
85 历史推荐 收藏视频
86 风格推荐 收藏 MV
87 排行列表 视频详情
88 排行榜推荐列表 相关视频
89 排行榜往期列表 关注用户
90 排行榜信息 新歌速递
91 排行榜歌曲列表 喜欢音乐列表(无序)
92 歌曲评论 收藏的 MV 列表
93 歌曲评论-根据分类返回 获取最新专辑
94 歌曲评论-根据热词返回 听歌打卡
95 楼层评论 获取视频标签/分类下的视频
96 歌单评论 已收藏专辑列表
97 专辑评论 获取动态评论
98 歌曲曲谱 歌单收藏者列表
99 曲谱详情 云盘歌曲删除
100 推荐曲谱 热门话题
101 曲谱合集 电台 - 推荐类型
102 曲谱合集详情 电台 - 非热门类型
103 提交听歌历史 电台 - 今日优选
104 获取服务器时间 心动模式/智能播放
105 刷刷 转发动态
106 AI 推荐 删除动态
107 频道 - 获取用户所有频道 分享歌曲、歌单、mv、电台、电台节目到动态
108 频道 - 详情 通知-私信
109 频道 - 频道安利 通知-评论
110 频道 - 相似频道 通知-@我
111 频道 - 订阅 通知-通知
112 频道 - 音乐故事 设置
113 频道 - 音乐故事详情 云盘数据详情
114 动态 - 最常访问 私信内容
115 获取用户公开的音乐 我的数字专辑
116 听书 - 每日推荐 batch 批量请求接口
117 听书 - 排行榜推荐 获取视频标签列表
118 听书 - VIP 推荐 全部 mv
119 听书 - 每周推荐 网易出品 mv
120 听书 - 专辑详情 收藏/取消收藏专辑
121 听书 - 专辑音乐列表 专辑动态信息
122 歌曲详情 - 歌曲成绩单 热搜列表(详细)
123 歌曲详情 - 歌曲成绩单详情 更换绑定手机
124 检测手机号码是否已注册
125 初始化昵称
126 更新歌单描述
127 更新歌单名
128 更新歌单标签
129 默认搜索关键词
130 删除歌单
131 电台 banner
132 用户电台
133 热门电台
134 电台 - 节目详情
135 电台 - 节目榜
136 电台 - 新晋电台榜/热门电台榜
137 类别热门电台
138 云村热评
139 电台 24 小时节目榜
140 电台 24 小时主播榜
141 电台最热主播榜
142 电台主播新人榜
143 电台付费精品榜
144 歌手热门 50 首歌曲
145 购买数字专辑
146 获取 mv 点赞转发评论数数据
147 获取视频点赞转发评论数数据
148 调整歌单顺序
149 调整歌曲顺序
150 独家放送列表
151 获取推荐视频
152 获取视频分类列表
153 获取全部视频列表接口
154 获取历史日推可用日期列表
155 获取历史日推详细数据
156 国家编码列表
157 首页-发现
158 首页-发现-圆形图标入口列表
159 数字专辑-全部新碟
160 数字专辑-热门新碟
161 数字专辑&数字单曲-榜单
162 数字专辑-语种风格馆
163 数字专辑详情
164 更新头像
165 歌单封面上传
166 楼层评论
167 歌手全部歌曲
168 精品歌单标签列表
169 用户等级信息
170 电台个性推荐
171 用户绑定信息
172 用户绑定手机
173 新版评论
174 点赞过的视频
175 收藏视频到视频歌单
176 删除视频歌单里的视频
177 最近播放的视频
178 音乐日历
179 电台订阅者列表
180 云贝签到信息
181 云贝签到
182 云贝所有任务
183 云贝 todo 任务
184 云贝今日签到信息
185 云贝完成任务
186 云贝收入
187 云贝支出
188 云贝账户信息
189 账号信息
190 最近联系人
191 私信音乐
192 抱一抱评论
193 评论抱一抱列表
194 收藏的专栏
195 关注歌手新歌
196 关注歌手新 MV
197 歌手详情
198 云盘上传
199 二维码登录
200 话题详情
201 话题详情热门动态
202 歌单详情动态
203 绑定手机
204 一起听状态
205 用户历史评论
206 云盘歌曲信息匹配纠正
207 云贝推歌
208 云贝推歌历史记录
209 已购单曲
210 获取 mlog 播放地址
211 将 mlog id 转为视频 id
212 vip 成长值
213 vip 成长值获取记录
214 vip 任务
215 领取 vip 成长值
216 歌手粉丝
217 数字专辑详情
218 数字专辑销量
219 音乐人数据概况
220 音乐人播放趋势
221 音乐人任务
222 账号云豆数
223 领取云豆
224 获取 VIP 信息
225 音乐人签到
226 发送文本动态
227 获取客户端歌曲下载 url
228 获取歌单所有歌曲
229 乐签信息
230 最近播放-歌曲
231 最近播放-视频
232 最近播放-声音
233 最近播放-歌单
234 最近播放-专辑
235 最近播放-播客
236 签到进度
237 重复昵称检测
238 歌手粉丝数量
239 音乐人任务(新)
240 内部版本接口
241 歌单更新播放量
242 黑胶时光机
243 音乐百科 - 简要信息
244 乐谱列表
245 乐谱内容
246 曲风列表
247 曲风偏好
248 曲风详情
249 曲风-歌曲
250 曲风-专辑
251 曲风-歌单
252 曲风-歌手
253 私信和通知接口
254 回忆坐标
255 播客搜索
256 播客声音上传
257 验证接口-二维码生成
258 验证接口-二维码检测
259 听歌识曲
260 根据 nickname 获取 userid 接口
261 播客声音列表
262 专辑简要百科信息
263 歌曲简要百科信息
264 歌手简要百科信息
265 mv 简要百科信息
266 搜索歌手
267 用户贡献内容
268 用户贡献条目、积分、云贝数量
269 年度听歌报告
270 播客声音搜索
271 播客声音排序
272 播客列表详情
273 本地歌曲文件匹配网易云歌曲信息
274 歌曲音质详情
275 歌曲红心数量
276 私人 FM 模式选择
277 播客删除
278 电台排行榜获取
279 获取声音歌词
280 获取专辑歌曲的音质
281 歌手动态信息
282 最近听歌列表
283 云盘导入歌曲
284 获取客户端歌曲下载链接 - 新版
285 当前账号关注的用户/歌手
286 会员下载歌曲记录
287 会员本月下载歌曲记录
288 已购买单曲
289 歌曲是否喜爱
290 用户是否互相关注
291 歌曲动态封面
292 用户徽章
293 用户状态
294 用户状态 - 支持设置的状态
295 用户状态 - 相同状态的用户
296 用户状态 - 编辑
297 听歌足迹 - 年度听歌足迹
298 听歌足迹 - 今日收听
299 听歌足迹 - 总收听时长
300 听歌足迹 - 本周/本月收听时长
301 听歌足迹 - 周/月/年收听报告
302 歌单导入 - 元数据/文字/链接导入
303 歌单导入 - 任务状态
304 副歌时间
305 相关歌单推荐
306 歌词摘录 - 歌词摘录信息
307 歌词摘录 - 我的歌词本
308 歌词摘录 - 添加/修改摘录歌词
309 歌词摘录 - 删除摘录歌词
310 广播电台 - 分类/地区信息
311 广播电台 - 我的收藏
312 广播电台 - 电台信息
313 广播电台 - 全部电台
314 广播电台 - 收藏/取消收藏电台
315 用户的创建歌单列表
316 用户的收藏歌单列表

🙏 致谢

本项目的成功离不开许多优秀开源项目的支持,在此由衷感谢这些项目的贡献者们,是他们的共同努力让这个有趣的项目得以实现:

  • QuickJS - 轻量级 JavaScript 引擎
  • QuickJS-NG - QuickJS 的活跃维护分支
  • 各类音乐平台 Node.js API 项目 - 为本项目的核心逻辑提供了基础(出于版权考虑,不在此详细列举)

感谢所有为开源社区做出贡献的开发者!

🔗 相关链接

❓ 常见问题 (FAQ)

Q1: 这个项目可以用于商业用途吗?

A: 不可以。本项目仅供学习使用,请勿用于商业用途。请尊重版权,支持正版音乐平台。

Q2: 为什么需要预编译库?

A: 本项目使用 C 语言核心库,需要预先编译为对应平台的二进制文件。你可以从主仓库的 Release 页面下载对应平台的预编译库。

Q3: 支持哪些音乐平台?

A: 目前支持网易云音乐和酷狗音乐,后续计划支持腾讯音乐等其他平台。

Q4: 如何贡献新的语言绑定?

A: 欢迎贡献!你可以参考现有的 Python 或 Dart 绑定的实现方式,基于 C 语言接口开发新的语言绑定。完成后提交 Pull Request 即可。

Q5: 遇到问题怎么办?

A: 欢迎提交 Issue,我们会尽快回复。也欢迎直接贡献代码解决问题。

📄 许可证

本项目采用 MIT 许可证开源。

MIT License

Copyright (c) 2026 MusicLibrary

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🤝 贡献

欢迎提交 Issue 和 Pull Request!

About

多语言音乐 API 绑定库,支持网易云(NeteaseCloudMusicApi)、酷狗(KuGouMusicApi)的音乐服务,已绑定 python语言 和 dart语言,实现 netease 与 kugou 数据操作和访问,适用于音乐应用学习讨论。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages