qqmusic-api-python 0.1.2__tar.gz

qqmusic_api_python-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Luren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qqmusic_api_python-0.1.2/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.1
+Name: qqmusic-api-python
+Version: 0.1.2
+Summary: QQ音乐API封装库
+Home-page: https://github.com/luren-dc/QQMusicApi
+License: MIT
+Keywords: music,api,qqmusic,tencentmusic
+Author: Luren
+Author-email: dluren.c@gmail.com
+Maintainer: Luren
+Maintainer-email: dluren.c@gmail.com
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Framework :: aiohttp
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: aiohttp (>=3.9.5,<4.0.0)
+Requires-Dist: cryptography (>=41.0.2,<42.0.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Project-URL: Documentation, https://github.com/luren-dc/QQMusicApi
+Project-URL: Repository, https://github.com/luren-dc/QQMusicApi
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <h1> QQMusic Api </h1>
+    <p> Python QQ音乐 API 封装库 </p>
+
+![Python Version 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+![GitHub license](https://img.shields.io/github/license/luren-dc/PyQQMusicApi)
+
+</div>
+
+---
+
+> [!WARNING]
+> 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途。
+
+文档: [https://luren-dc.github.io/QQMusicApi/](https://luren-dc.github.io/QQMusicApi/)
+
+## 介绍
+
+使用 Python 编写的用于调用 [QQ音乐](https://y.qq.com/) 各种 API 的库.
+
+## 依赖
+
+本项目基于：
+
+- [AIOHTTP](https://docs.aiohttp.org/)
+- [Requests](https://requests.readthedocs.io/)
+- [Cryptography](https://cryptography.io/)
+
+## 快速上手
+
+### 安装
+
+#### pypi
+
+```shell
+$ pip install qqmusic-api-python
+```
+
+#### source
+
+```shell
+$ pip install git+https://github.com/luren-dc/QQMusicApi.git
+```
+
+### 使用
+
+```python
+import asyncio
+
+from qqmusic_api import search
+
+async def main():
+    # 搜索歌曲
+    result = await search.search_by_type(keyword="周杰伦", num=20)
+    # 打印结果
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## TODO
+
+- [ ] 歌手 API
+- [ ] 评论 API
+- [ ] 用户 API
+
+## 参考项目
+
+- [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/)
+
+## Licence
+
+**[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)**
+

qqmusic_api_python-0.1.2/README.md

@@ -0,0 +1,78 @@
+<div align="center">
+    <h1> QQMusic Api </h1>
+    <p> Python QQ音乐 API 封装库 </p>
+
+![Python Version 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+![GitHub license](https://img.shields.io/github/license/luren-dc/PyQQMusicApi)
+
+</div>
+
+---
+
+> [!WARNING]
+> 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途。
+
+文档: [https://luren-dc.github.io/QQMusicApi/](https://luren-dc.github.io/QQMusicApi/)
+
+## 介绍
+
+使用 Python 编写的用于调用 [QQ音乐](https://y.qq.com/) 各种 API 的库.
+
+## 依赖
+
+本项目基于：
+
+- [AIOHTTP](https://docs.aiohttp.org/)
+- [Requests](https://requests.readthedocs.io/)
+- [Cryptography](https://cryptography.io/)
+
+## 快速上手
+
+### 安装
+
+#### pypi
+
+```shell
+$ pip install qqmusic-api-python
+```
+
+#### source
+
+```shell
+$ pip install git+https://github.com/luren-dc/QQMusicApi.git
+```
+
+### 使用
+
+```python
+import asyncio
+
+from qqmusic_api import search
+
+async def main():
+    # 搜索歌曲
+    result = await search.search_by_type(keyword="周杰伦", num=20)
+    # 打印结果
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## TODO
+
+- [ ] 歌手 API
+- [ ] 评论 API
+- [ ] 用户 API
+
+## 参考项目
+
+- [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/)
+
+## Licence
+
+**[MIT License](https://github.com/luren-dc/QQMusicApi?tab=MIT-1-ov-file)**

qqmusic_api_python-0.1.2/pyproject.toml

@@ -0,0 +1,68 @@
+[tool.poetry]
+name = "qqmusic-api-python"
+version = "0.1.2"
+description = "QQ音乐API封装库"
+authors = ["Luren <dluren.c@gmail.com>"]
+packages = [{ include = "qqmusic_api" }]
+license = "MIT"
+readme = "README.md"
+maintainers = ["Luren <dluren.c@gmail.com>"]
+homepage = "https://github.com/luren-dc/QQMusicApi"
+repository = "https://github.com/luren-dc/QQMusicApi"
+documentation = "https://github.com/luren-dc/QQMusicApi"
+keywords = ["music", "api", "qqmusic", "tencentmusic"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Natural Language :: Chinese (Simplified)",
+  "License :: OSI Approved :: MIT License",
+  "Framework :: Pytest",
+  "Framework :: aiohttp",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[tool.poetry.dependencies]
+python = "^3.9"
+cryptography = "^41.0.2"
+requests = "^2.31.0"
+aiohttp = "^3.9.5"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.2.0"
+pytest-asyncio = "^0.23.6"
+pytest-sugar = "^1.0.0"
+pre-commit = "^3.7.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.mypy]
+pretty = true
+python_version = 3.9
+show_column_numbers = true
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint]
+select = [
+    "F",
+    "E",
+    "W",
+    "I",
+    "TCH",
+    "UP",
+]
+
+[tool.pytest.ini_options]
+pythonpath = "./"
+testpaths = ["tests"]
+asyncio_mode = "auto"

qqmusic_api_python-0.1.2/qqmusic_api/__init__.py

@@ -0,0 +1,17 @@
+from . import album, login, mv, search, singer, song, songlist, top
+from .utils.credential import Credential
+from .utils.network import get_aiohttp_session, set_aiohttp_session
+
+__all__ = [
+    "album",
+    "Credential",
+    "get_aiohttp_session",
+    "login",
+    "mv",
+    "search",
+    "set_aiohttp_session",
+    "singer",
+    "song",
+    "songlist",
+    "top",
+]

qqmusic_api_python-0.1.2/qqmusic_api/album.py

@@ -0,0 +1,38 @@
+from .song import Song
+from .utils.network import Api
+from .utils.utils import get_api
+
+API = get_api("album")
+
+
+class Album:
+    """
+    专辑类
+    """
+
+    def __init__(self, mid: str):
+        """
+        Args:
+            mid: 专辑 mid
+        """
+        self.mid = mid
+
+    def __repr__(self) -> str:
+        return f"Album(mid={self.mid})"
+
+    async def get_detail(self) -> dict:
+        """
+        Returns:
+            dict: 专辑详细信息
+        """
+        return await Api(**API["detail"]).update_params(albumMid=self.mid).result
+
+    async def get_song(self) -> list[Song]:
+        """
+        获取专辑歌曲
+
+        Returns:
+            list: 歌曲列表
+        """
+        result = await Api(**API["song"]).update_params(albumMid=self.mid, begin=0, num=0).result
+        return [Song.from_dict(song["songInfo"]) for song in result["songList"]]

qqmusic_api_python-0.1.2/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_python-0.1.2/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_python-0.1.2/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_python-0.1.2/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_python-0.1.2/qqmusic_api/data/api/singer.json

@@ -0,0 +1,48 @@
+{
+    "singer_list": {
+        "module": "music.musichallSinger.SingerList",
+        "method": "GetSingerList",
+        "params": {
+            "area": "int 地区码",
+            "sex": "int 性别",
+            "genre": "int 风格",
+            "hastag": "int 返回标签"
+        },
+        "comment": "获取歌手列表"
+    },
+    "homepage": {
+        "module": "music.UnifiedHomepage.UnifiedHomepageSrv",
+        "method": "GetHomepageHeader",
+        "params": {
+            "SingerMid": "str 歌手 mid",
+            "IsQueryTabDetail": "int  是否返回 Tab 详细信息",
+            "TabID": "int TabID",
+            "Order": "int 排序"
+        },
+        "comment": "获取歌手主页信息"
+    },
+    "desc": {
+        "module": "music.musichallSinger.SingerInfoInter",
+        "method": "GetSingerDetail",
+        "params": {
+            "singer_mids": "list 歌手 mid 列表",
+            "group_singer": "int 1",
+            "wiki_singer": "int 1"
+        },
+        "comment": "获取歌手简介"
+    },
+    "homepage_tab_detail": {
+        "module": "music.UnifiedHomepage.UnifiedHomepageSrv",
+        "method": "GetHomepageTabDetail",
+        "params": {
+            "SingerMid": "str 歌手 mid",
+            "IsQueryTabDetail": "int  是否返回 Tab 详细信息",
+            "TabID": "int TabID",
+            "PageNum": "int 页码",
+            "PageSize": "int 返回数量",
+            "StartIndex": "int 开始位置",
+            "Order": "int 排序"
+        },
+        "comment": "获取歌手首页 Tab 栏信息"
+    }
+}

qqmusic_api_python-0.1.2/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": "获取下载链接"
+    }
+}