三分钟上手的QQ音乐下载工具：把喜欢的声音真正留下来

【免费下载链接】MCQTSS_QQMusicQQ音乐解析项目地址: https://gitcode.com/gh_mirrors/mc/MCQTSS_QQMusic

深夜11点，你窝在沙发上，耳机里循环着一首老歌。想把它下载下来，会员却已过期，在线转换工具转出的音频满是沙沙声。这种"听得见、带不走"的憋屈，正是开源项目MCQTSS_QQMusic想解决的核心矛盾——它专注于 QQ音乐解析，把搜索、下载、歌单、MV 的能力整整齐齐摆到你面前。

如果你也收藏过几百首歌、倒腾过各种"转音质"网站，下面这份指南会帮你把耳朵真正做主。全程不需要懂代码，跑通一个命令，你就能拿到第一首属于自己的歌。

三分钟上手：先跑起来，再慢慢懂

别急着研究原理，先让工具"开口说话"。前提只有一个：电脑上装好Python 3.9+。然后打开终端，依次执行：

git clone https://gitcode.com/gh_mirrors/mc/MCQTSS_QQMusic cd MCQTSS_QQMusic pip install requests pyexecjs python demo.py

就这么简单。demo.py会自动搜索"周杰伦"的前20首热门歌曲，每一首都带上歌曲名、ID、Mid、专辑、歌手完整信息，紧接着还会输出第一首歌的专辑详情、真实播放 URL 和逐行歌词。

第一次运行，你什么都不用懂，只要看到屏幕上出现一行音乐播放URL:，就说明这条路通了——先跑起来，再慢慢懂，是这个工具最大的善意。而最常用的搜索、解析功能，连 Cookie 都不用填。

功能逐层拆解：它能替你做什么

整个项目核心是一个QQ_Music类，所有能力都集中在 Main.py 里。对应到你的日常需求，无非四件事。

🔍 只凭歌名，精准锁定目标

想找一首歌但只记得歌名？search_music()一次请求就能返回20首候选结果，歌手、专辑、歌曲 Mid 全部齐活。实测单次搜索响应在1秒以内，比在网页里来回翻页快得多。

更有意思的是，QQ音乐旧版搜索接口被停用后，项目又跟进写出了新版接口 search_music_new/search_music.py，连网页端用来生成searchid的 JavaScript 都被逆向成了 getsearchid.js。官方换了门，这边就换把钥匙，这种"跟得上"的维护态度，是开源工具最值钱的地方。

📥 从"只能在线播"到"真实可下载"

很多在线工具给你的是一个加密链接，或者转码后严重缩水的音频。而get_music_url()拿到的是 QQ音乐 CDN 上的真实播放地址，直接用下载器拉下来即可，最大程度保留原始音质。

对比一下就明白了：普通在线转换工具要粘贴链接、等转码、再下载，折腾三分钟还带回音；这里一行调用返回dl.stream.qqmusic.qq.com直链，全程不到半秒。

📃 歌单批量下载，告别一首首点

这是收藏党最爱的一招。get_playlist_info()先帮你把歌单的名称、简介、作者、播放量、收藏量摸清楚，同时返回前10首歌；接着用get_playlist_info_num()按15首一档往下拉，不管歌单是100首还是500首，都能一次拿全。

配合一个简单的循环脚本，你就能在几分钟内把整个歌单的下载地址全部列出来，再交给下载器排队下载。参考写法在 demo_1.py。

🎬 MV 高清下载，画质自主选择

想要 MV？get_mv_url()输入视频 VID，返回的信息里带多个分辨率选项，filetype数值越高画质越高。项目里还有专门的 demo_mv.py 演示脚本，运行后直接打印出每个分辨率对应的文件大小和下载 URL，挑最大的下，就是最清晰的版本。

原理大白话：仓库、门禁卡和万能钥匙孔

不用懂加密，三个比喻就够了。

服务器是一座装满歌曲的仓库。每次请求都要刷"门禁卡"，这张卡就是请求签名。官方客户端每秒钟生成无数张看似随机的卡，其实都遵循同一套规则：把请求内容做一次 MD5 运算，再与一组固定数字做异或、重排、拼接，最后变成一串以zzb开头的字符。Main.py里的get_sign()函数，就是这台"制卡机"——规则一旦被还原，门禁卡就能随手复制。

Cookie 是你的"会员卡"。绿钻专属歌曲只有绿钻身份才放行。Cookie 就是那个身份凭证，通过set_cookie()填进程序，绿钻曲库即刻解封。注意它有有效期，过期了重贴一张即可。

musicu.fcg是仓库的万能钥匙孔。项目里绝大多数解析都走u.y.qq.com/cgi-bin/musicu.fcg这个统一接口：只要把从网页抓到的data（一段 JSON）塞进?data=参数，服务器就会照单执行。下图就是抓取这段data的方法——打开开发者工具的 Network 面板，找到请求，红框标注的 JSON 就是它。

抓包视角下的接口请求与响应：红框中的 data 就是解析的"原料"

避坑答疑：新手最容易踩的5个坑

1. 返回Error或500001？九成是 Cookie 过期，或者你拿着普通身份去解析绿钻专属歌曲。先换新 Cookie，再确认歌曲权限。

2. Cookie 怎么拿？打开 QQ音乐官网并登录 → 按 F12 进入开发者工具 → 切到 Network 面板刷新页面 → 在 Fetch/XHR 里点开任意一个请求 → 复制 Request Headers 里的 Cookie 即可。

红框标注的就是需要复制的 Cookie，粘贴进 set_cookie() 即可生效

3. 搜不到想要的歌？旧版搜索接口已被官方停用，请改用search_music_new/里的新版搜索方法，这是经过验证的当前可用方案。

4. 提示缺模块？确保执行过pip install requests pyexecjs，其中pyexecjs用于运行 JavaScript 生成 searchid，只有新版搜索才需要。

5. 只有命令行，没有界面？它本质是一个 Python 库，你可以把它嵌入任何自己的程序。官方还配套了一个图形界面的播放器 MCQTSS Music，搜索、播放、下载一体化，命令行恐惧症也有救。

玩法延伸：三个让它更值钱的用法

玩法一：打造自己的离线音乐库。写个小脚本，遍历歌单 → 逐个取 URL → 下载并按"歌手-专辑-歌名"自动归档。配合配套播放器，你就拥有了一座随时可听、永不掉线的私人曲库。

MCQTSS Music 播放器界面，解析到的歌曲可直接播放与下载

玩法二：榜单与歌单数据做分析。demo_toplist.py 能一次性拉出流行指数榜，包含排名和上升百分比；get_recommended_playlist()还能抓取官方推荐歌单。做音乐趋势分析、内容选题参考，数据信手拈来。

玩法三：把歌词"玩出花"。get_lyrics()支持逐行歌词和译文，配合translate参数还能拿到双语对照——做桌面歌词、卡拉OK字幕、外语歌学习素材都绰绰有余。

写在最后

这款工具最打动人的地方，是它把"搜索—解析—下载"这条原本锁死的链路，重新交还给了普通用户。它不复杂，却足够聪明：你不需要成为技术专家，也能拥有选择自己音乐的权利。

当然，技术是中立的，使用它的方式决定了价值。请仅将本项目用于个人学习与欣赏，支持正版、尊重版权，别让工具变成伤害创作者的帮凶。

音乐是人类共同的精神财富，而技术的意义，从来都是让更多人触碰到它——哪怕只是一首深夜想听的老歌。现在，轮到你把它下载下来了。

【免费下载链接】MCQTSS_QQMusicQQ音乐解析项目地址: https://gitcode.com/gh_mirrors/mc/MCQTSS_QQMusic