Agent Skills
返回列表
🎨

网易云音乐批量下载器

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_d910d7c0/netease-music-downloader。

技能介绍

问题背景

给本地播放器准备测试曲库时，手动从网易云音乐下载歌曲会遇到几个具体麻烦：外链返回的可能是 HTML 错误页而不是 MP3，搜索结果里混着 AI 伪歌和翻唱，试听片段体积只有几百 KB，歌词和封面还要另外找。VIP 歌曲的完整音频任何接口都拿不到，但免费可外链的歌曲本可以批量搞定。

核心能力与工作流程

scripts/download.py 把整条链路串成一条命令：搜索 → 过滤（精确匹配 + 时长校验）→ 试外链（验证 MP3 头）→ 下载 → 歌词 → 封面 → ID3 写入。

核心流程包括：

  • 搜索与过滤：调用搜索接口拿到候选列表，按 fee=0（免费）和热度排序逐个尝试，自动跳过返回 HTML 错误页的 VIP 歌曲
  • 反伪歌过滤：通过时长校验识别试听片段，加「原唱」「正式版」等特征词降低翻唱混入概率
  • 歌词与封面：歌词走 lyric 接口，封面走三层换源（网易云专辑 API → Deezer → 渐变色占位图）
  • ID3 写入：用 mutagen 写入 TIT2/TPE1/TALB/APIC 标签，文件名统一为「歌手 - 歌名.mp3」

歌单用纯文本维护，每行一首歌，# 开头为注释，空行自动跳过。重复执行是幂等的，已存在的文件只补缺失的歌词和封面。

适用边界与避坑

几个明确的边界：

  • VIP 歌曲下不到：版权受限歌曲平台不放行外链，这不是工具问题
  • 路径不要用中文：Windows 下脚本自身要放在英文路径，输出目录可以中文
  • 不支持分享链接：脚本按「歌手 歌名」搜索，不解析链接
  • 仅限个人学习测试：只下载 fee=0 的免费歌，商用需用公版或 CC 授权音乐

使用场景

  • 给Electron点歌器准备测试曲库，需要批量下载免费歌曲并自动补齐歌词和封面
  • 国内网络下archive.org和GitHub直连不可用，需要用网易云免费外链作为音频兜底方案
  • 维护长期曲库时希望改一个文本歌单就能批量增删歌曲，重复执行不产生重复下载
  • 排查为什么某首歌没下到时，需要看清候选版本的fee、时长和是否被伪歌过滤

适合人员

  • 开发本地播放器或点歌器的工程师，需要快速生成测试音频曲库
  • 为AI对话应用配置点歌技能的开发者，希望用户用自然语言就能触发下载
  • 音乐类工具的维护者，需要在国内网络下稳定获取免费可外链音频做功能验证
  • 喜欢DIY本地播放器的个人用户，希望按歌单批量整理自己的免费歌曲库