musicdl：纯 Python 开源音乐下载器，60 个音源一条命令搜全网

每天一个开源项目

网易云、QQ 音乐凑不齐的歌，这个开源音乐下载器 musicdl 能搜 60 个音源，纯 Python 写的，建议先收藏。

{ 一个跑了 8 年的纯 Python 项目 }

musicdl 在 GitHub 上约 6100 Star，作者是 CharlesPikachu。

项目 2020 年发布，累计提交超过 1100 次，最近一次代码提交就在昨天。

定位很直白，纯 Python 搜索歌曲、下载音频，代码库干净，Windows、macOS、Linux 都能跑。

翻它 README 的时候，最先注意到的是更新日志。最新版本 v2.13.11 的说明写的是「例行维护酷狗、网易云、汽水、QQ 音乐的接口」。

几乎每隔几天就发一个版本，专门修某个平台失效的接口。

它真正在做的，是跟几十个平台不断变化的接口赛跑。8 年 1100 多次提交，大部分工作量都花在这。

{ 60 个音源，一次搜完 }

README 把音源分成五类，加起来接近 60 个：

装好之后，一条命令就能同时在网易云和 QQ 音乐里搜：

pip install musicdl
musicdl -k "告白气球" -m NeteaseMusicClient,QQMusicClient

想批量下一个歌单，把 -k 换成 -p，后面接歌单链接就行。

终端里还有交互模式，方向键移动、空格选中、a 全选。说实话，这手感比不少带 GUI 的小工具还舒服。

{ 三个容易忽略的细节 }

1. 它可以当 SDK 用

除了命令行，.search() 和 .download() 是分开的，能直接塞进自己的脚本：

from musicdl import musicdl

client = musicdl.MusicClient(music_sources=['NeteaseMusicClient'])
results = client.search(keyword='周杰伦')

做音乐检索、批量采集数据集的人会很顺手。

2. 没有歌词的平台，它自己生成

喜马拉雅、荔枝FM 这类平台拿不到歌词，项目内置了 WhisperLRC，基于 faster-whisper 把音频转成 LRC 文件。

from musicdl.modules import WhisperLRC

WhisperLRC(model_size_or_path='base').fromfilepath('xxx.flac')

3. 它已经接上 MCP 了

仓库里有个 mcp 目录，能直接挂给大模型调用。想让 AI 帮你找歌下歌，这条路是通的。

{ 有几点得说清楚 }

第一是许可证。项目用的是 PolyForm Noncommercial 1.0.0，明确禁止商业使用和重新打包分发。想拿它做产品，不行。

第二是高音质要自己动手。默认只能下普通音质，想要无损，得填对应平台的会员 Cookie。README 只给了配置项，没给现成 Cookie。

第三是接口会失效。下载失败先去看有没有新版，这基本是这个项目的日常。

README 的免责声明写了：只跟公开可访问的接口交互，不托管任何版权内容，也不允许绕过付费墙和 DRM。用之前心里得有这条线。

{ 怎么开始 }

核心就一句 pip install musicdl，剩下的是按需补依赖：

• 通用音源：FFmpeg
• YouTube Music：Node.js
• Apple Music / TIDAL：额外需要 N_m3u8DL-RE 和 Bento4

嫌命令行麻烦的，作者还有个网页版 Demo 叫 MusicSquare，浏览器里就能搜、能听、能下。

顺手去 GitHub 点个 Star 吧，这种天天跟接口变化较劲的项目，值得留着。

GitHub musicdl

纯 Python 轻量级音乐下载器，支持数十个平台

https://github.com/CharlesPikachu/musicdl

#开源 #音乐下载器 #GitHub #Python #效率工具 #网易云音乐 #QQ音乐 #无损音乐