🔱netease-cloud-music🔱

网易云音乐 Golang API 接口 + 命令行工具套件 + 一键完成任务

⚠️ 声明

本项目仅供个人学习使用,切勿用于商业用途、非法用途使用！！！

使用此项目遇到封号等问题概不负责,使用前请谨慎考虑！！！

如有侵权即删！！！

📖 功能

命令行 (ncmctl)

• 一键每日任务完成(音乐合伙人、云贝签到、刷歌300首)
• 每日签到(云贝签到,连续签到奖励目前需要手动领取)
• “音乐合伙人”自动测评(5首基础歌曲 + 2到7首随机额外歌曲测评，另不包含"歌曲推荐"测评)
• 每日刷歌300首(带去重功能)
• 云盘上传(支持并行批量上传)
• .ncm文件解析转换为.mp3/.flac(支持并行批量解析)
• crypto支持接口参数加解密便于调试
• curl子命令调用网易云音乐API,无需关心出入参数加解密问题便于调试
  • 支持动态链接请求
• 音乐下载，支持标准、高品质、极高(HQ)、无损(SQ)、Hi-Res品质下载
• vip每日签到
• vip日常任务完成(待考虑)
• “音乐人”任务自动完成(待考虑)
• proxy 代理

api

• weapi 网页端、小程序使用
• eapi PC端、移动端使用

目前由于本人时间精力有限,暂未书写文档,不过可以参考api目录下代码,代码通俗易懂,且有注释.

提示: 目前主要实现了weapi也推荐使用weapi,接口相对较全，如需要其他接口可提 issue。

💻 要求

• golang >= 1.21
• makefile (可选)
• git (可选)
• docker (可选)

ncmctl

🔨 安装

可执行文件安装

go install github.com/chaunsin/netease-cloud-music/cmd/ncmctl@latest

或

git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make install

提示: 默认会安装到$GOPATH/bin目录下

docker版本镜像获取方式

docker pull chaunsin/ncmctl:latest # dockerhub镜像仓库
docker pull ghcr.io/chaunsin/ncmctl:latest # github镜像仓库

镜像仓库以及docker使用方式: https://hub.docker.com/r/chaunsin/ncmctl

如有条件自编译镜像

git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make build-iamge

提示: 自行编译需要安装docker环境,另外受国服环境影响最好开梯子。

青龙脚本使用方式请参考:

qinglong.md

🚀 使用

一、二维码登录

ncmctl login qrcode

提示: 使用手机登录网易云音乐app进行扫码授权登录，如果不能识别终端打印的二维码可根据终端输出得文件路径提示找到二维码图片进行扫描,或者copy终端输出得 qrcode content: https://www.163.com/xxx 内容自己生成二维码再进行扫描(粘贴时不要包含qrcode content: 以及结尾空格)。扫描有时效性,默认超时时间为5分钟,另外扫码过程中 不能退出终端!!! 如有问题可重复此流程,为避免被风控不要频繁登录。

在线生成二维码工具: https://www.bejson.com/convert/qrcode/#google_vignette

二、一键执行每日所有任务

ncmctl task

提示: 默认task包含

• sign (签到)
• partner (音乐合伙人)
• scrobble (刷歌300首)

如果只运行某一个任务,比如签到:

ncmctl task --sign

另外partner"音乐合伙人"资格不是所有人都有，网易会不定期私信邀请一部分人成为音乐合伙人。由于ncmctl task 默认是执行所有任务，因此没有该资格得人执行如下

ncmctl task --sign --scrobble 

如果想更改某一个任务默认运行时间,比如刷歌(scrobble)在每天晚上20:00:00点执行.

ncmctl task --scrobble.cron "0 20 * * *"

提示:

• 需要登录
• 本命令会以服务得方式一直持续运行,如要退出,请使用ctrl+c退出。
• ncmctl 采用标准的crontab 表达式进行管理。crontab表达式编写工具>>>点我<<<

三、音乐下载

1. 下载Hi-Res品质音乐

# 指定歌曲分享链接
ncmctl download -l hires 'https://music.163.com/song?id=1820944399'
# 指定歌曲id
ncmctl download -l hires '1820944399'

提示: url地址获取方式可以从分享中获取。如果知道歌曲id可以省略url地址，目前id仅支持歌曲id，不支持其他例如歌手、专辑、歌单id等。

2. 下载无损品质(SQ)音乐,到当前download目录下

ncmctl download -l SQ 'https://music.163.com/song?id=1820944399' -o ./download/ 

提示: 支持得音质有(从低到高) standard/128 < higher/192 < exhigh/HQ/320 < lossless/SQ < hires/HR 参数可指定任意别名。

3. 下载某一张专辑所有音乐,批量下载数量5(最大值20)

ncmctl download -p 5 'https://music.163.com/#/album?id=34608111'

提示: 默认批量下载到当前download目录下面，音质为无损(SQ)

4. 下载某一歌手的所有音乐

ncmctl download --strict 'https://music.163.com/#/artist?id=33400892'

提示: --strict为严格默认,当歌曲没有对应品质的音乐时则会忽略下载,如果不指定--strict则默认下载次一级的音乐品质。比如指定HR品质没有对应得资源则下载SQ。

5. 下载某一歌单

# web端链接
ncmctl download 'https://music.163.com/#/my/m/music/playlist?id=593617579'
# pc端链接 
ncmctl download 'https://music.163.com/playlist?id=593617579'

四、云盘上传

指定文件上传

ncmctl cloud '/Users/chaunsin/Music/谁为我停留 - 田震.mp3' 

指定目录上传(批量上传)

ncmctl cloud '/Users/chaunsin/Music/' 

提示: 默认批量上传数为3,最大为10,可指定-p参数设置,同时cloud支持按照自定义过滤条件进行上传详情可使用-h参考命令行。另外输入的目录深度不能超过3层。

五、.ncm文件解析

批量解析/Users/chaunsin/Music/目录输出到./ncm目录下

ncmctl ncm '/Users/chaunsin/Music/' -o ./ncm

提示: 支持批量解析,默认参数为10，可以指定-p参数设置数量。同样输入的目录深度不能超过3层。

六、其他命令

$ ncmctl --help
ncmctl is a toolbox for netease cloud music.

Usage:
  ncmctl [command]

Examples:
  ncmctl cloud
  ncmctl crypto
  ncmctl login
  ncmctl curl
  ncmctl partner

Available Commands:
  cloud       [need login] Used to upload music files to netease cloud disk
  completion  Generate the autocompletion script for the specified shell
  crypto      Crypto is a tool for encrypting and decrypting the http data
  curl        Like curl invoke netease cloud music api
  download    [need login] Download songs
  help        Help about any command
  login       Login netease cloud music
  logout      Logout netease cloud music
  ncm         Automatically parses .ncm to mp3/flac
  partner     [need login] Executive music partner daily reviews
  scrobble    [need login] Scrobble execute refresh 300 songs
  sign        [need login] Sign perform daily cloud shell check-in and vip check-in
  task        [need login] Daily tasks are executed asynchronously [partner、scrobble、sign]

Flags:
  -c, --config string   configuration file path
      --debug           run in debug mode
  -h, --help            help for ncmctl
      --home string     configuration home path. the home path is used to store running information (default "/Users/chaunsin")
  -v, --version         version for ncmctl

Use "ncmctl [command] --help" for more information about a command.

提示: 内容以实际命令行为准

api

参考如下

• 登录
• 云盘上传(需要登录)
• 音乐下载(需要登录)

❓ 已知问题

1.下载无损音乐品质不准确

当使用ncmctl下载无损音乐指定-l lossless时,会存在下载Hi-Res品质音乐情况,如果歌曲不支持Hi-Res品质音乐,同时有无损品质音乐则正常下载无损音乐,问题还需要排查。

2.每日刷歌300首为啥达不到300首

scrobble是支持去重功能的,会在$HOME/.ncmctl/database/记录听过哪些歌曲记录，但是目前没有找到这样的一个接口,判断当前账户听过哪些歌曲,因此这就会造成每日听歌达不到300首的情况。

举个例子,在使用本程序之前,你听过某一首歌曲比如反方向的钟 - 周杰伦 ,由于此歌曲没有记录到数据库中,即视为未听过该歌曲造成了重复播放,进而导致不满足300首。

综上所述强烈建议不要清理$HOME/.ncmctl/database/目录下的文件数据,除非你知道你在干什么。

另外还有一种极端情况,刷歌采用的歌单是top榜单歌曲(top榜单歌曲相对来说都是新歌,不同得歌单更新频率不一样) ，top榜单有50个左右，虽然看起来很多,但实际上还是存在不满足300首新歌情况,如果网易新歌曲更新得不及时,由于有判重复逻辑,因此还是会存在不满足300首得情况。

3.ncmctl task和scrobble、sign、partner子命令有啥区别？

task命令是一个服务，默认执行是包含了scrobble、sign、partner子命令功能，启动之后会每天定时执行,如果把此命令部署到服务器上并配合 nohup命令去启动就不用每天手动去执行一遍任务了。

再说一下scrobble、sign、partner。这几个子命令不是服务，执行之后会立刻执行相应得任务并返回结果，不像task执行需要”到点了“才会执行。

❤️ 鸣谢

• https://github.com/Binaryify/NeteaseCloudMusicApi
• https://github.com/mos9527/pyncm
• https://github.com/naruto2o2o/musicdump
• https://crontab.guru

以及本项目所依赖的三方优秀库。