已移动至 pycloudmusic 仓库下 docs 部署于 github pages https://fengliufeseliud.github.io/pycloudmusic/

介绍

pycloudmusic 是异步高性能的 Python 音乐 API 库

开箱即用/简单/快速

基于 NeteaseCloudMusicApi 改写

安装

使用 pip 即可安装 pycloudmusic

pip install pycloudmusic

输出对象

pycloudmusic 下的所有对象被打印时都会格式化输出类所有变量， 方便查看对象数据

from pycloudmusic import Music163Api
import asyncio


async def main():
    musicapi = Music163Api()
    # 获取歌曲 421531
    # https://music.163.com/#/song?id=421531
    music = await musicapi.music(421531)
    # 打印歌曲信息
    print(music)
    print("=" * 50)

asyncio.run(main())

此处数据为打印歌单对象

可迭代对象

pycloudmusic 下的部分对象可以被迭代使用

如下获取歌单 PlayList 对象后可以直接 for in PlayList 对象， 将迭代返回按歌单曲目生成的 Music 对象

from pycloudmusic import Music163Api
import asyncio


async def main():
    musicapi = Music163Api()
    # 获取歌单 7487291782
    # https://music.163.com/#/playlist?id=7487291782
    playlist = await musicapi.playlist(7487291782)
    # 打印歌单信息
    print(playlist)
    print("=" * 50)

    # 打印歌单曲目
    for music in playlist:
        print(music.name, music.artist_str, music.id)

asyncio.run(main())

因此可以使用推导式快速生成 task 列表下载歌单曲目

from pycloudmusic import Music163Api
import asyncio


async def main():
    musicapi = Music163Api()
    # 获取歌单 7487291782
    # https://music.163.com/#/playlist?id=7487291782
    playlist = await musicapi.playlist(7487291782)
    # 创建任务
    tasks = [asyncio.create_task(music.play()) for music in playlist]
    # 等待任务
    await asyncio.wait(tasks)

asyncio.run(main())

模拟登录

pycloudmusic 支持邮箱登录， 二维码登录， 手机密码登录， 手机验证码登录

这里可以用邮箱登录长期保持 Cookie 有效性，邮箱登录不需要人为操作

from pycloudmusic import LoginMusic163
import asyncio


async def main():
    login = LoginMusic163()
    # 邮箱登录
    code, cookie, musicapi = await login.email("you login email", "you login password")
    # 验证登录
    print("=" * 60)
    print(code, cookie, musicapi)
    print("=" * 60)
    print(await musicapi.my())

asyncio.run(main())

评论

pycloudmusic 支持网易云的所有评论， 对支持评论的对象使用 Music163Comment 的方法即可

使用 Page

"""获取歌曲所有评论"""

from pycloudmusic import Music163Api, Page
import asyncio


async def main():
    musicapi = Music163Api()
    # 获取歌曲
    # https://music.163.com/song?id=1902224491&userid=492346933
    music = await musicapi.music(1902224491)
    # 按时间获取评论
    async for comments in Page(music.comments, hot=False):
        for comment in comments:
            print(f"{comment.user_str}:  {comment.content}")

asyncio.run(main())

自定义迭代

"""获取歌曲所有评论"""

import math
from pycloudmusic import Music163Api
import asyncio


async def main():
    musicapi = Music163Api()
    
    # https://music.163.com/song?id=1899317143
    music = await musicapi.music(1899317143)

    count, comments = await music.comments(hot=False)
    page = math.ceil(count / 20)

    all_count = 0
    while page > -1:
        count, comments = await music.comments(hot=False, page=page)

        for comment in comments:
            print(comment)

        page -= 1

asyncio.run(main())

错误处理

API 返回 200 以外状态码触发 Music163BadCode 错误

错误对象.code 获取 API 状态码，错误对象.data 获取 API 数据

from pycloudmusic import Music163Api, Music163BadCode
import asyncio


async def main():
    musicapi = Music163Api()

    try:
        playlist = await musicapi.playlist(7487291782)
    except Music163BadCode as err:
        print(err, err.code, err.data)

asyncio.run(main())