qqmusic-api-python 0.1.0__py3-none-any.whl

qqmusic_api/api/top.py

@@ -0,0 +1,98 @@
+from qqmusic_api.api.song import Song
+from qqmusic_api.utils.network import Api
+from ..utils.common import get_api
+import datetime
+
+API = get_api("top")
+
+
+async def get_top_category(show_detail: bool = False) -> list[dict]:
+    """
+    获取所有排行榜
+
+    Args:
+        show_detail: 是否显示详情(包括介绍，前三歌曲). Defaults to False
+
+    Returns:
+        list: 排行榜信息
+    """
+    result = await Api(**API["category"]).result
+    return [
+        {
+            "groupId": group["groupId"],
+            "groupTitle": group["groupName"],
+            "topList": [
+                {
+                    "id": top["topId"],
+                    "title": top["title"],
+                    "intro": top["intro"] if show_detail else None,
+                    "period": top["period"],
+                    "updateTime": top["updateTime"],
+                    "listenNum": top["listenNum"],
+                    "picUrl": top["headPicUrl"],
+                    "song": top["song"] if show_detail else None,
+                }
+                for top in group["toplist"]
+            ],
+        }
+        for group in result["group"]
+    ]
+
+
+class Top:
+    """排行榜类"""
+
+    def __init__(self, id: int, period: str = "") -> None:
+        """
+        Args:
+            id: 排行榜 ID
+            period: 排行榜周期
+        """
+        self.id = id
+        self.set_period(period)
+
+    def set_period(self, period: str):
+        """
+        设置排行榜周期
+
+        Args:
+            year: 年
+            week: 周
+        """
+        time_type = "%Y-%m-%d" if self.id in [4, 27, 62] else "'%Y_%W"
+        self.period = period or datetime.datetime.strftime(
+            datetime.datetime.now(), time_type
+        )
+
+    async def get_detail(self):
+        """
+        获取排行榜详细信息
+
+        Returns:
+            dict: 排行榜信息
+        """
+        param = {"topId": self.id, "period": self.period}
+        result = await Api(**API["detail"]).update_params(**param).result
+        data = result["data"]
+        return {
+            "id": data["topId"],
+            "title": data["title"],
+            "subTitle": data["titleSub"],
+            "titleDetail": data["titleDetail"],
+            "desc": data["intro"],
+            "listenNum": data["listenNum"],
+            "total": data["totalNum"],
+            "updateTime": data["updateTime"],
+            "period": self.period,
+        }
+
+    async def get_song(self) -> list[Song]:
+        """
+        获取排行榜歌曲
+
+        Returns:
+            list: 排行榜歌曲
+        """
+        param = {"topId": self.id, "period": self.period, "offset": 0, "num": 100}
+        result = await Api(**API["detail"]).update_params(**param).result
+        return [Song.from_dict(song) for song in result["songInfoList"]]

qqmusic_api/data/api/album.json

@@ -0,0 +1,20 @@
+{
+    "detail": {
+        "module": "music.musichallAlbum.AlbumInfoServer",
+        "method": "GetAlbumDetail",
+        "params": {
+            "albumMid": "str 专辑 mid"
+        },
+        "comment": "获取专辑信息"
+    },
+    "song": {
+        "module": "music.musichallAlbum.AlbumSongList",
+        "method": "GetAlbumSongList",
+        "params": {
+            "albumMid": "str 专辑 mid",
+            "begin": "int 开启位置",
+            "num": "int 返回数量"
+        },
+        "comment": "获取专辑歌曲"
+    }
+}

qqmusic_api/data/api/login.json

@@ -0,0 +1,69 @@
+{
+    "QQ_login": {
+        "module": "QQConnectLogin.LoginServer",
+        "method": "QQLogin",
+        "params": {
+            "code": "str 鉴权码"
+        },
+        "extra_common": {
+            "tmeLoginType": "str 2"
+        },
+        "comment": "QQ 鉴权"
+    },
+    "WX_login": {
+        "module": "music.login.LoginServer",
+        "method": "Login",
+        "params": {
+            "strAppid": "wx48db31d50e334801",
+            "code": "str 鉴权码"
+        },
+        "extra_common": {
+            "tmeLoginType": "str 1"
+        },
+        "comment": "微信鉴权"
+    },
+    "send_authcode": {
+        "module": "music.login.LoginServer",
+        "method": "SendPhoneAuthCode",
+        "params": {
+            "tmeAppid": "qqmusic",
+            "phoneNo": "str 手机号",
+            "areaCode": "int 地区码(86)"
+        },
+        "extra_common": {
+            "tmeLoginMethod": "str 3"
+        },
+        "comment": "发送验证码"
+    },
+    "phone_login": {
+        "module": "music.login.LoginServer",
+        "method": "Login",
+        "params": {
+            "code": "str 验证码",
+            "phoneNo": "str 手机号",
+            "loginMode": "int 1"
+        },
+        "extra_common": {
+            "tmeLoginMethod": "str 3"
+        },
+        "comment": "发送验证码"
+    },
+    "refresh": {
+        "module": "music.login.LoginServer",
+        "method": "Login",
+        "params": {
+            "openid": "str",
+            "access_token": "str",
+            "refresh_token": "str",
+            "expired_in": "int",
+            "musicid": "str 必须",
+            "musickey": "str",
+            "refresh_key": "str 必须",
+            "loginMode": "int 2"
+        },
+        "extra_common": {
+            "tmeLoginMethod": "str 可填2"
+        },
+        "comment": "刷新cookies"
+    }
+}

qqmusic_api/data/api/mv.json

@@ -0,0 +1,26 @@
+{
+    "detail": {
+        "module": "video.VideoDataServer",
+        "method": "get_video_info_batch",
+        "params": {
+            "vidlist": "list vid 列表",
+            "required": "list 查询字段"
+        },
+        "comment": "获取 MV 信息"
+    },
+    "url": {
+        "module": "music.stream.MvUrlProxy",
+        "method": "GetMvUrls",
+        "params": {
+            "vids": "list vid 列表",
+            "request_type": "int 10003",
+            "guid": "str 随机32位字符串",
+            "videoformat": "int 1",
+            "format": "int 265",
+            "dolby": "int 1",
+            "use_new_domain": "int 1",
+            "use_ipv6": "int 1"
+        },
+        "comment": "获取 MV 播放地址"
+    }
+}

qqmusic_api/data/api/search.json

@@ -0,0 +1,73 @@
+{
+    "hotkey": {
+        "module": "music.musicsearch.HotkeyService",
+        "method": "GetHotkeyForQQMusicMobile",
+        "params": {
+            "search_id": "int 随机生成"
+        },
+        "comment": "获取热搜词"
+    },
+    "complete": {
+        "module": "tencent_music_soso_smartbox_cgi.SmartBoxCgi",
+        "method": "GetSmartBoxResult",
+        "params": {
+            "query": "str 搜索词",
+            "num_per_page": "int 每页返回数量",
+            "highlight": "int 是否高亮搜索词",
+            "page_idx": "int 页数"
+        },
+        "comment": "获取搜索词补全"
+    },
+    "quick_search": {
+        "url": "https://c.y.qq.com/splcloud/fcgi-bin/smartbox_new.fcg",
+        "method": "GET",
+        "params": {
+            "key": "str 搜索词"
+        },
+        "comment": "桌面端快速搜索"
+    },
+    "general_search": {
+        "module": "music.adaptor.SearchAdaptor",
+        "method": "do_search_v2",
+        "params": {
+            "search_id": "int 随机生成",
+            "search_type": "int 100",
+            "query": "str 搜索词",
+            "highlight": "int 是否高亮搜索词",
+            "grp": "int 是否返回歌曲其他版本",
+            "page_id": "int 页数"
+        },
+        "comment": "综合搜索"
+    },
+    "desktop_search_by_type": {
+        "module": "music.search.SearchCgiService",
+        "method": "DoSearchForQQMusicDesktop",
+        "params": {
+            "search_id": "int 随机生成",
+            "search_type": "int 搜索类型",
+            "query": "str 搜索词",
+            "highlight": "int 是否高亮搜索词",
+            "page_id": "int 页数",
+            "page_num": "int 页数",
+            "num_per_page": "int 每页返回数量",
+            "selectors": "dict 选择器"
+        },
+        "comment": "桌面端搜索"
+    },
+    "mobile_search_by_type": {
+        "module": "music.search.SearchCgiService",
+        "method": "DoSearchForQQMusicMobile",
+        "params": {
+            "search_id": "int 随机生成",
+            "search_type": "int 搜索类型",
+            "query": "str 搜索词",
+            "highlight": "int 是否高亮搜索词",
+            "page_id": "int 页数",
+            "page_num": "int 页数",
+            "grp": "int 是否返回歌曲其他版本",
+            "num_per_page": "int 每页返回数量",
+            "selectors": "dict 选择器"
+        },
+        "comment": "手机端搜索"
+    }
+}

qqmusic_api/data/api/singer.json

@@ -0,0 +1 @@
+{}

qqmusic_api/data/api/song.json

@@ -0,0 +1,105 @@
+{
+    "query": {
+        "module": "music.trackInfo.UniformRuleCtrl",
+        "method": "CgiGetTrackInfo",
+        "params": {
+            "ids": "list id列表",
+            "mids": "list mid列表",
+            "types": "[0 for i in range(len(id or mid))]",
+            "modify_stamp": "[0 for i in range(len(id or mid))]",
+            "ctx": "int 0",
+            "client": "int 1"
+        },
+        "comment": "使用 ID 或 mid 查询歌曲"
+    },
+    "detail": {
+        "module": "music.pf_song_detail_svr",
+        "method": "get_song_detail_yqq",
+        "params": {
+            "song_id": "int 歌曲 ID",
+            "song_mid": "str 歌曲 mid"
+        },
+        "comment": "获取歌曲详细信息"
+    },
+    "similar": {
+        "module": "music.recommend.TrackRelationServer",
+        "method": "GetSimilarSongs",
+        "params": {
+            "songid": "int 歌曲 ID"
+        },
+        "comment": "获取相似歌曲"
+    },
+    "labels": {
+        "module": "music.recommend.TrackRelationServer",
+        "method": "GetSongLabels",
+        "params": {
+            "songid": "int 歌曲 ID"
+        },
+        "comment": "获取歌曲标签"
+    },
+    "playlist": {
+        "module": "music.recommend.TrackRelationServer",
+        "method": "GetRelatedPlaylist",
+        "params": {
+            "songid": "int 歌曲 ID"
+        },
+        "comment": "获取相关歌单"
+    },
+    "mv": {
+        "module": "MvService.MvInfoProServer",
+        "method": "GetSongRelatedMv",
+        "params": {
+            "songid": "int 歌曲 ID",
+            "songmid": "str 歌曲 mid"
+        },
+        "comment": "获取相关MV"
+    },
+    "other": {
+        "module": "music.musichallSong.OtherVersionServer",
+        "method": "GetOtherVersionSongs",
+        "params": {
+            "songid": "int 歌曲 ID",
+            "songmid": "str 歌曲 mid"
+        },
+        "comment": "获取其他版本"
+    },
+    "sheet": {
+        "module": "music.mir.SheetMusicSvr",
+        "method": "GetMoreSheetMusic",
+        "params": {
+            "songmid": "str 歌曲 mid"
+        },
+        "comment": "获取相关曲谱"
+    },
+    "producer": {
+        "module": "music.sociality.KolWorksTag",
+        "method": "SongProducer",
+        "params": {
+            "songid": "int 歌曲 ID",
+            "songmid": "str 歌曲 mid"
+        },
+        "comment": "获取歌曲制作团队"
+    },
+    "play_url": {
+        "module": "music.vkey.GetVkey",
+        "method": "UrlGetVkey",
+        "params": {
+            "filename": "[f'{file_type.s}{_}{_}{file_type.e}' for _ in mid]",
+            "guid": "str 随机32位字符串",
+            "songmid": "list mid 列表",
+            "songtype": "[1 for _ in range(len(mid))]"
+        },
+        "comment": "获取播放链接"
+    },
+    "download_url": {
+        "module": "music.vkey.GetDownUrl",
+        "method": "CgiGetDownUrl",
+        "params": {
+            "filename": "[f'{file_type.s}{_}{_}{file_type.e}' for _ in mid]",
+            "guid": "str 随机32位字符串",
+            "songmid": "list mid 列表",
+            "songtype": "[1 for _ in range(len(mid))]"
+        },
+        "comment": "获取下载链接"
+    }
+}

qqmusic_api/data/api/songlist.json

@@ -0,0 +1,17 @@
+{
+    "detail": {
+        "module": "srf_diss_info.DissInfoServer",
+        "method": "CgiGetDiss",
+        "params": {
+            "disstid": "int 歌单ID",
+            "dirid": "int 0",
+            "tag": "int 是否返回歌曲标签",
+            "onlysonglist": "int 是否只返回歌曲",
+            "song_begin": "int 开始位置",
+            "song_num": "int 返回数量",
+            "userinfo": "int 是否返回以后信息",
+            "orderlist": "int 是否排序歌单",
+            "caller": "str musicid"
+        }
+    }
+}

qqmusic_api/data/api/top.json

@@ -0,0 +1,20 @@
+{
+    "category": {
+        "module": "music.musicToplist.Toplist",
+        "method": "GetAll",
+        "params": {},
+        "comment": "获取所有榜单"
+    },
+    "detail": {
+        "module": "music.musicToplist.Toplist",
+        "method": "GetDetail",
+        "params": {
+            "topId": "int 榜单ID",
+            "offset": "int 开始位置",
+            "num": "int 返回数量",
+            "withTags": "bool 是否返回歌曲标签",
+            "period": "str 榜单周期"
+        },
+        "comment": "获取榜单详情"
+    }
+}

qqmusic_api/data/file_type.json

@@ -0,0 +1,50 @@
+{
+    "new_0": {
+        "s": "AI00",
+        "e": ".flac"
+    },
+    "new_1": {
+        "s": "Q000",
+        "e": ".flac"
+    },
+    "new_2": {
+        "s": "Q001",
+        "e": ".flac"
+    },
+    "flac": {
+        "s": "F000",
+        "e": ".flac"
+    },
+    "ogg_192": {
+        "s": "O600",
+        "e": ".ogg"
+    },
+    "ogg_96": {
+        "s": "O400",
+        "e": ".ogg"
+    },
+    "mp3_320": {
+        "s": "M800",
+        "e": ".mp3"
+    },
+    "mp3_128": {
+        "s": "M500",
+        "e": ".mp3"
+    },
+    "acc_192": {
+        "s": "C600",
+        "e": ".m4a"
+    },
+    "acc_96": {
+        "s": "C400",
+        "e": ".m4a"
+    },
+    "acc_48": {
+        "s": "C200",
+        "e": ".m4a"
+    },
+    "try": {
+        "s": "RS02",
+        "e": ".mp3"
+    }
+}

qqmusic_api/data/search_type.json

@@ -0,0 +1,11 @@
+{
+    "song": 0,
+    "singer": 1,
+    "album": 2,
+    "songlist": 3,
+    "mv": 4,
+    "lyric": 7,
+    "user": 8,
+    "audio_album": 15,
+    "audio": 18
+}

qqmusic_api/exceptions.py

@@ -0,0 +1,121 @@
+class ApiException(Exception):
+    """
+    API 异常基类
+    """
+
+    def __init__(self, msg: str = "未知原因"):
+        super().__init__(msg)
+        self.msg = msg
+
+    def __str__(self):
+        return self.msg
+
+
+class ArgsException(ApiException):
+    """
+    参数错误。
+    """
+
+    def __init__(self, msg: str):
+        super().__init__(msg)
+        self.msg = msg
+
+
+class ClientException(ApiException):
+    """
+    服务器连接错误
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "连接到服务器时出现了问题"
+
+
+class NetworkException(ApiException):
+    """
+    网络错误
+    """
+
+    def __init__(self, status: int, msg: str):
+        super().__init__(msg)
+        self.status = status
+        self.msg = f"网络错误，状态码：{status} - {msg}"
+
+    def __str__(self):
+        return self.msg
+
+
+class ResponseCodeException(ApiException):
+    """
+    API 返回 code 错误
+    """
+
+    def __init__(self, code: int, subcode: int, api: list):
+        super().__init__()
+        self.msg = "API 返回 code 错误"
+        self.code = code
+        self.subcode = subcode
+        self.api = api
+
+    def __str__(self):
+        return f"接口信息：{'.'.join(self.api)} 错误代码：{self.code} | {self.subcode}"
+
+
+class CredientialCanNotRefreshException(ApiException):
+    """
+    Crediential 无法刷新
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "Crediential 无法刷新，请检查是否缺少必要字段"
+
+
+class CredentialNoMusicidException(ApiException):
+    """
+    Crediential 缺少 Musicid
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "Crediential 缺少 Musicid"
+
+
+class CredentialNoMusickeyException(ApiException):
+    """
+    Crediential 缺少 Musickey
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "Crediential 缺少 Musickey"
+
+
+class LoginDevicesFullException(ApiException):
+    """
+    登录设备已满
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "登录设备已满"
+
+
+class AuthcodeExpiredException(ApiException):
+    """
+    验证码已失效
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "验证码已失效"
+
+
+class AuthcodeGetFrequentlyException(ApiException):
+    """
+    验证码获取频繁
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.msg = "验证码获取频繁"

qqmusic_api/settings.py

@@ -0,0 +1,22 @@
+from .utils.common import random_string
+from .utils.qimei import Qimei
+
+# 接口参数配置
+# API接口
+API_URL = "https://u.y.qq.com/cgi-bin/musicu.fcg"
+
+# QQ音乐版本号
+QQMUSIC_VERSION = "13.2.5.8"
+QQMUSIC_VERSION_CODE = 13020508
+
+
+def get_qimei36(version):
+    result = Qimei.get(version)
+    if result.q36:
+        return result.q36
+    else:
+        return "cc8d07a748d4be0a8b91eacd100014a1730e"
+
+
+QIMEI36 = get_qimei36(QQMUSIC_VERSION)
+UID = random_string(10, "0123456789")