qqmusic-api-python 0.1.7__tar.gz → 0.1.9__tar.gz

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qqmusic-api-python
-Version: 0.1.7
+Version: 0.1.9
 Summary: QQ音乐API封装库
 Keywords: music,api,qqmusic,tencentmusic
 Home-page: https://github.com/luren-dc/QQMusicApi
@@ -20,7 +20,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Project-URL: Homepage, https://github.com/luren-dc/QQMusicApi
 Project-URL: Repository, https://github.com/luren-dc/QQMusicApi
 Project-URL: Documentation, https://github.com/luren-dc/QQMusicApi
-Requires-Python: <4.0,>=3.9
+Requires-Python: <3.13,>=3.9
 Requires-Dist: cryptography<42.0.0,>=41.0.2
 Requires-Dist: typing-extensions>=4.12.2
 Requires-Dist: httpx>=0.27.0
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
     <h1> QQMusicApi </h1>
     <p> Python QQ音乐 API 封装库 </p>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/python-3.9+-blue" alt="Python">
+        <img src="https://img.shields.io/badge/python-3.9|3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/astral-sh/ruff">
         <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -53,6 +53,8 @@ Description-Content-Type: text/markdown
 
 > [!WARNING]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
+>
+> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 
@@ -101,9 +103,15 @@ asyncio.run(main())
 
 ## 参考项目
 
-- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-music-api)
-- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
-- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+### API
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+
+### QRC 解密
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+
+### 项目架构
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
 
 ## Licence
 

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/README.md

@@ -2,7 +2,7 @@
     <h1> QQMusicApi </h1>
     <p> Python QQ音乐 API 封装库 </p>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/python-3.9+-blue" alt="Python">
+        <img src="https://img.shields.io/badge/python-3.9|3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/astral-sh/ruff">
         <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -25,6 +25,8 @@
 
 > [!WARNING]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
+>
+> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 
@@ -73,9 +75,15 @@ asyncio.run(main())
 
 ## 参考项目
 
-- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-music-api)
-- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
-- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+### API
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+
+### QRC 解密
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+
+### 项目架构
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
 
 ## Licence
 

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
     "typing-extensions>=4.12.2",
     "httpx>=0.27.0",
 ]
-requires-python = "<4.0,>=3.9"
+requires-python = "<3.13,>=3.9"
 readme = "README.md"
 maintainers = [
     { name = "Luren", email = "68656403+luren-dc@users.noreply.github.com" },
@@ -39,7 +39,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dynamic = []
-version = "0.1.7"
+version = "0.1.9"
 
 [project.license]
 text = "MIT"
@@ -69,6 +69,8 @@ docs = [
     "mkdocs>=1.6.0",
     "markdown-callouts>=0.4.0",
     "griffe-inherited-docstrings>=1.0.0",
+    "docstring-inheritance>=2.2.1",
+    "griffe-modernized-annotations>=1.0.8",
 ]
 mypy = [
     "mypy>=1.11.0",
@@ -143,3 +145,4 @@ testpaths = [
     "tests",
 ]
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/__init__.py

@@ -1,15 +1,16 @@
-from . import album, login, lyric, mv, search, singer, song, songlist, top
+from . import album, login, login_utils, lyric, mv, search, singer, song, songlist, top, user
 from .utils.credential import Credential
 from .utils.network import get_session, set_session
 from .utils.sync import sync
 
-__version__ = "0.1.7"
+__version__ = "0.1.9"
 
 __all__ = [
     "album",
     "Credential",
     "get_session",
     "login",
+    "login_utils",
     "lyric",
     "mv",
     "search",
@@ -19,4 +20,5 @@ __all__ = [
     "songlist",
     "sync",
     "top",
+    "user",
 ]

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/album.py

@@ -1,6 +1,6 @@
 """专辑相关 API"""
 
-from typing import Optional
+from typing import Literal, Optional
 
 from .utils.network import Api
 from .utils.utils import get_api
@@ -8,6 +8,21 @@ from .utils.utils import get_api
 API = get_api("album")
 
 
+def get_album_cover(mid: str, size: Literal[150, 300, 500, 800] = 300) -> str:
+    """获取专辑封面链接
+
+    Args:
+        mid: 专辑 mid
+        size: 封面大小
+
+    Returns:
+        封面链接
+    """
+    if size not in [150, 300, 500, 800]:
+        raise ValueError("not supported size")
+    return f"https://y.gtimg.cn/music/photo_new/T002R{size}x{size}M000{mid}.jpg"
+
+
 class Album:
     """专辑类
 
@@ -33,8 +48,8 @@ class Album:
         """
         if mid is None and id is None:
             raise ValueError("mid or id must be provided")
-        self.mid = mid
-        self.id = id
+        self.mid = mid or ""
+        self.id = id or 0
         self._info: Optional[dict] = None
 
     async def get_mid(self) -> str:
@@ -43,7 +58,9 @@ class Album:
         Returns:
             专辑 mid
         """
-        return (await self.get_detail())["basicInfo"]["albumMid"]
+        if not self.mid:
+            self.mid = (await self.get_detail())["basicInfo"]["albumMid"]
+        return self.mid
 
     async def get_id(self) -> int:
         """获取专辑 id
@@ -51,7 +68,9 @@ class Album:
         Returns:
             专辑 id
         """
-        return (await self.get_detail())["basicInfo"]["albumID"]
+        if not self.id:
+            self.id = (await self.get_detail())["basicInfo"]["albumID"]
+        return self.id
 
     async def get_detail(self) -> dict:
         """获取专辑详细信息

qqmusic_api_python-0.1.9/qqmusic_api/data/api/login.json

@@ -0,0 +1,196 @@
+{
+    "qq": {
+        "get_qrcode": {
+            "url": "https://ssl.ptlogin2.qq.com/ptqrshow",
+            "params": {
+                "appid": "716027609",
+                "e": "2",
+                "l": "M",
+                "s": "3",
+                "d": "72",
+                "v": "4",
+                "t": "str(random.random())",
+                "daid": "383",
+                "pt_3rd_aid": "100497308"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取二维码二进制数据和 qrsig"
+        },
+        "check_qrcode_state": {
+            "url": "https://ssl.ptlogin2.qq.com/ptqrlogin",
+            "params": {
+                "u1": "https://graph.qq.com/oauth2.0/login_jump",
+                "ptqrtoken": "hash33(qrsig)",
+                "ptredirect": "0",
+                "h": "1",
+                "t": "1",
+                "g": "1",
+                "from_ui": "1",
+                "ptlang": "2052",
+                "action": "0-0-{time.time() * 1000}",
+                "js_ver": "20102616",
+                "js_type": "1",
+                "pt_uistyle": "40",
+                "aid": "716027609",
+                "daid": "383",
+                "pt_3rd_aid": "100497308",
+                "has_onekey": "1"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取二维码状态"
+        },
+        "check_sig": {
+            "url": "https://ssl.ptlogin2.graph.qq.com/check_sig",
+            "ignore_code": true,
+            "params": {
+                "uin": "uin",
+                "pttype": "1",
+                "service": "ptqrlogin",
+                "nodirect": "0",
+                "ptsigx": "sigx",
+                "s_url": "https://graph.qq.com/oauth2.0/login_jump",
+                "ptlang": "2052",
+                "ptredirect": "100",
+                "aid": "716027609",
+                "daid": "383",
+                "j_later": "0",
+                "low_login_hour": "0",
+                "regmaster": "0",
+                "pt_login_type": "3",
+                "pt_aid": "0",
+                "pt_aaid": "16",
+                "pt_light": "0",
+                "pt_3rd_aid": "100497308"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取 p_skey"
+        },
+        "authorize": {
+            "url": "https://graph.qq.com/oauth2.0/authorize",
+            "method": "POST",
+            "ignore_code": true,
+            "data": {
+                "response_type": "code",
+                "client_id": "100497308",
+                "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=1&surl=https%3A%252F%252Fy.qq.com%252F",
+                "scope": "get_user_info,get_app_friends",
+                "state": "state",
+                "switch": "",
+                "from_ptlogin": "1",
+                "src": "1",
+                "update_auth": "1",
+                "openapi": "1010_1030",
+                "g_tk": "hash33(p_skey, 5381)",
+                "auth_time": "str(int(time.time()) * 1000)",
+                "ui": "str(uuid.uuid4())"
+            },
+            "comment": "QQ 鉴权"
+        },
+        "login": {
+            "module": "QQConnectLogin.LoginServer",
+            "method": "QQLogin",
+            "ignore_code": true,
+            "params": {
+                "code": "str 鉴权码",
+                "musicid": "int",
+                "musickey": "str",
+                "refresh_key": "str",
+                "refresh_token": "str"
+            },
+            "extra_common": {
+                "tmeLoginType": "str 2"
+            },
+            "comment": "QQ 登录"
+        }
+    },
+    "wx": {
+        "get_qrcode": {
+            "url": "https://open.weixin.qq.com/connect/qrconnect",
+            "params": {
+                "appid": "wx48db31d50e334801",
+                "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=2&surl=https://y.qq.com/",
+                "response_type": "code",
+                "scope": "snsapi_login",
+                "state": "STATE",
+                "href": "https://y.qq.com/mediastyle/music_v17/src/css/popup_wechat.css#wechat_redirect"
+            },
+            "comment": "获取二维码二进制数据和 uuid"
+        },
+        "check_qrcode_state": {
+            "url": "https://lp.open.weixin.qq.com/connect/l/qrconnect",
+            "params": {
+                "uuid": "str uuid",
+                "_": "str 毫秒级时间戳"
+            },
+            "headers": {
+                "Referer": "https://open.weixin.qq.com/"
+            },
+            "comment": "获取二维码状态"
+        },
+        "login": {
+            "module": "music.login.LoginServer",
+            "method": "Login",
+            "ignore_code": true,
+            "params": {
+                "strAppid": "wx48db31d50e334801",
+                "code": "str 鉴权码",
+                "musicid": "int",
+                "musickey": "str",
+                "refresh_key": "str",
+                "refresh_token": "str",
+                "loginMode": "int 2"
+            },
+            "extra_common": {
+                "tmeLoginType": "str 1"
+            },
+            "comment": "微信登录"
+        }
+    },
+    "phone": {
+        "send_authcode": {
+            "module": "music.login.LoginServer",
+            "method": "SendPhoneAuthCode",
+            "ignore_code": true,
+            "params": {
+                "tmeAppid": "qqmusic",
+                "phoneNo": "str 手机号",
+                "encryptedPhoneNo ": "str 加密手机号",
+                "areaCode": "str 国家码(86)"
+            },
+            "extra_common": {
+                "tmeLoginMethod": "str 3"
+            },
+            "comment": "发送验证码"
+        },
+        "login": {
+            "module": "music.login.LoginServer",
+            "method": "Login",
+            "ignore_code": true,
+            "params": {
+                "code": "str 验证码",
+                "phoneNo": "str 手机号",
+                "encryptedPhoneNo ": "str 加密手机号",
+                "areaCode": "str 国家码(86)",
+                "loginMode": "int 1"
+            },
+            "extra_common": {
+                "tmeLoginMethod": "str 3",
+                "tmeLoginType": "str 0"
+            },
+            "comment": "手机验证码鉴权"
+        }
+    },
+    "check_expired": {
+        "module": "music.UserInfo.userInfoServer",
+        "method": "GetLoginUserInfo",
+        "verify": true,
+        "params": {},
+        "comment": "获取登录用户的信息，用于检测凭证是否失效"
+    }
+}

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/data/api/search.json

@@ -8,7 +8,7 @@
         "comment": "获取热搜词"
     },
     "complete": {
-        "module": "tencent_music_soso_smartbox_cgi.SmartBoxCgi",
+        "module": "music.smartboxCgi.SmartBoxCgi",
         "method": "GetSmartBoxResult",
         "params": {
             "search_id": "int 随机生成",
@@ -21,10 +21,11 @@
     "quick_search": {
         "url": "https://c.y.qq.com/splcloud/fcgi-bin/smartbox_new.fcg",
         "method": "GET",
+        "platform": "web",
         "params": {
             "key": "str 搜索词"
         },
-        "comment": "桌面端快速搜索"
+        "comment": "快速搜索"
     },
     "general_search": {
         "module": "music.adaptor.SearchAdaptor",
@@ -43,6 +44,7 @@
     "desktop_search_by_type": {
         "module": "music.search.SearchCgiService",
         "method": "DoSearchForQQMusicDesktop",
+        "platform": "desktop",
         "params": {
             "search_id": "int 随机生成",
             "search_type": "int 搜索类型",

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/data/api/song.json

@@ -68,7 +68,8 @@
         "module": "music.mir.SheetMusicSvr",
         "method": "GetMoreSheetMusic",
         "params": {
-            "songmid": "str 歌曲 mid"
+            "songmid": "str 歌曲 mid",
+            "scoreType": "int -1"
         },
         "comment": "获取相关曲谱"
     },

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/data/api/songlist.json

@@ -1,6 +1,6 @@
 {
     "detail": {
-        "module": "srf_diss_info.DissInfoServer",
+        "module": "music.srfDissInfo.DissInfo",
         "method": "CgiGetDiss",
         "params": {
             "disstid": "int 歌单ID",
@@ -9,9 +9,9 @@
             "onlysonglist": "int 是否只返回歌曲",
             "song_begin": "int 开始位置",
             "song_num": "int 返回数量",
-            "userinfo": "int 是否返回以后信息",
+            "userinfo": "int 是否返回用户信息",
             "orderlist": "int 是否排序歌单",
-            "caller": "str musicid"
+            "enc_host_uin": "str encrypt_uin"
         }
     }
 }

qqmusic_api_python-0.1.9/qqmusic_api/data/api/user.json

@@ -0,0 +1,171 @@
+{
+    "profile": {
+        "url": "https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg",
+        "method": "GET",
+        "platform": "web",
+        "headers": {
+            "referer": "https://y.qq.com/"
+        },
+        "params": {
+            "ct": "int 20",
+            "cv": "int 4747474",
+            "cid": "int 205360838",
+            "userid": "str musicid or euin"
+        },
+        "comment": "获取用户主页，根据 cookie 值不同，内容有差异"
+    },
+    "vip_info": {
+        "module": "VipLogin.VipLoginInter",
+        "method": "vip_login_base",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录账号的 vip 信息"
+    },
+    "homepage": {
+        "module": "music.UnifiedHomepage.UnifiedHomepageSrv",
+        "method": "GetHomepageHeader",
+        "params": {
+            "uin": "str musicid or euin",
+            "IsQueryTabDetail": "int 1"
+        },
+        "comment": "获取用户主页信息(包含用户信息，音乐基因，乐库，用户歌单等信息)，根据 cookie 值不同，内容有差异"
+    },
+    "friend": {
+        "module": "music.homepage.Friendship",
+        "method": "GetFriendList",
+        "verify": true,
+        "params": {
+            "Page": "int 页数",
+            "PageSize": "int 每页数量"
+        },
+        "comment": "获取好友列表"
+    },
+    "songlist_by_euin": {
+        "url": "https://c6.y.qq.com/rsc/fcgi-bin/fcg_user_created_diss",
+        "method": "GET",
+        "platform": "web",
+        "headers": {
+            "referer": "https://y.qq.com/"
+        },
+        "params": {
+            "hostuin": "str encrypt_uin",
+            "sin": "int 页数",
+            "size": "int 每页返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取用户歌单列表"
+    },
+    "songlist_by_uin": {
+        "module": "music.musicasset.PlaylistBaseRead",
+        "method": "GetPlaylistByUin",
+        "platform": "desktop",
+        "params": {
+            "uin": "str uin"
+        },
+        "comment": "通过 uin 获取用户歌单列表"
+    },
+    "follow_singer": {
+        "module": "music.concern.RelationList",
+        "method": "GetFollowSingerList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取关注歌手列表"
+    },
+    "follow_user": {
+        "module": "music.concern.RelationList",
+        "method": "GetFollowUserList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取关注用户列表"
+    },
+    "fans": {
+        "module": "music.concern.RelationList",
+        "method": "GetFansList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取粉丝列表"
+    },
+    "fav_songlist_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderDiss",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏歌单"
+    },
+    "fav_album_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderAlbum",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏专辑"
+    },
+    "fav_mv_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderMV",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏MV"
+    },
+    "fav_songlist_by_euin": {
+        "module": "music.musicasset.PlaylistFavRead",
+        "method": "CgiGetPlaylistFavInfo",
+        "params": {
+            "uin": "str encrypt_uin",
+            "offset": "int 偏移量",
+            "size": "int 返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取收藏歌单"
+    },
+    "fav_album_by_euin": {
+        "module": "music.musicasset.AlbumFavRead",
+        "method": "CgiGetAlbumFavInfo",
+        "params": {
+            "euin": "str encrypt_uin",
+            "offset": "int 偏移量",
+            "size": "int 返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取收藏专辑"
+    },
+    "fav_mv": {
+        "module": "music.musicasset.MVFavRead",
+        "method": "getMyFavMV",
+        "verify": true,
+        "params": {
+            "uin": "str musicid or euin",
+            "support": "int 1",
+            "req_icon_type": "int 1"
+        },
+        "comment": "获取收藏 MV"
+    },
+    "fav_mv_by_euin": {
+        "module": "music.musicasset.MVFavRead",
+        "method": "getMyFavMV_v2",
+        "platform": "desktop",
+        "verify": true,
+        "params": {
+            "encuin": "str encrypt_uin",
+            "num": "int 返回数量",
+            "pagesize": "int 返回页数"
+        },
+        "comment": "通过 encrypt_uin 获取收藏 MV"
+    },
+    "music_gene": {
+        "module": "music.recommend.UserProfileSettingSvr",
+        "method": "GetProfileReport",
+        "params": {
+            "VisitAccount": "str encrypt_uin"
+        },
+        "comment": "获取音乐基因数据"
+    }
+}

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.9}/qqmusic_api/data/file_type.json

@@ -1,13 +1,13 @@
 {
-    "new_0": {
+    "master": {
         "s": "AI00",
         "e": ".flac"
     },
-    "new_1": {
+    "atmos_2": {
         "s": "Q000",
         "e": ".flac"
     },
-    "new_2": {
+    "atmos_51": {
         "s": "Q001",
         "e": ".flac"
     },
@@ -15,6 +15,10 @@
         "s": "F000",
         "e": ".flac"
     },
+    "ogg_640": {
+        "s": "O801",
+        "e": ".ogg"
+    },
     "ogg_320": {
         "s": "O800",
         "e": ".ogg"