260 lines
7.9 KiB
Markdown
260 lines
7.9 KiB
Markdown
# KuGouMusic API
|
||
|
||
酷狗音乐 NodeJS 版 API
|
||
|
||
[](https://github.com/MakcRe)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
[//]: # '<br>'
|
||
|
||
|
||
|
||
|
||
|
||
## 灵感来自
|
||
|
||
[Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)
|
||
|
||
## 环境要求
|
||
|
||
需要 NodeJS 12+ 环境
|
||
|
||
## 工作原理
|
||
|
||
跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API
|
||
|
||
## 免责声明
|
||
|
||
> 1. 本项目仅供学习使用，请尊重版权，请勿利用此项目从事商业行为及非法用途!
|
||
> 2. 使用本项目的过程中可能会产生版权数据。对于这些版权数据，本项目不拥有它们的所有权。为了避免侵权，使用者务必在 24 小时内清除使用本项目的过程中所产
|
||
> 生的版权数据。
|
||
> 3. 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停
|
||
> 工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责。
|
||
> 4. **禁止在违反当地法律法规的情况下使用本项目。** 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担，本
|
||
> 项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。
|
||
> 5. 音乐平台不易，请尊重版权，支持正版。
|
||
> 6. 本项目仅用于对技术可行性的探索及研究，不接受任何商业（包括但不限于广告等）合作及捐赠。
|
||
> 7. 如果官方音乐平台觉得本项目不妥，可联系本项目更改或移除。
|
||
|
||
### 安装
|
||
|
||
```shell
|
||
$ git clone git@github.com:MakcRe/KuGouMusicApi.git
|
||
$ cd KuGouMusicApi
|
||
$ npm install
|
||
```
|
||
|
||
### 使用接口为概念版
|
||
|
||
```
|
||
$ 复制 .env.example 为 .env，并且把里面的 `platform=''` 改为 `platform=lite`
|
||
$ 注意不同版本的平台的 token 是不通用的。
|
||
```
|
||
|
||
### 运行
|
||
|
||
```shell
|
||
$ npm run dev
|
||
```
|
||
|
||
服务器启动默认端口为 3000, 若不想使用 3000 端口 , 可使用以下命令 : Mac/Linux
|
||
|
||
```shell
|
||
$ PORT=4000 npm run dev
|
||
```
|
||
|
||
windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :
|
||
|
||
```shell
|
||
$ set PORT=4000 && npm run dev
|
||
```
|
||
|
||
windows 下使用 PowerShell 等终端执行以下命令 :
|
||
|
||
```shell
|
||
$ $Env:PORT=4000; npm run dev
|
||
```
|
||
|
||
服务器启动默认 host 为 localhost,如果需要更改, 可使用以下命令 : Mac/Linux
|
||
|
||
```shell
|
||
$ HOST=127.0.0.1 npm run dev
|
||
```
|
||
|
||
windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :
|
||
|
||
```shell
|
||
$ set HOST=127.0.0.1 && npm run dev
|
||
```
|
||
|
||
windows 下使用 PowerShell 等终端执行以下命令 :
|
||
|
||
```shell
|
||
$ $Env:HOST=127.0.0.1; npm run dev
|
||
```
|
||
|
||
### 代理配置
|
||
|
||
如需通过 HTTP 代理请求酷狗接口，可在启动前设置 `KUGOU_API_PROXY` 环境变量，例如:
|
||
|
||
```shell
|
||
$ $Env:KUGOU_API_PROXY='http://127.0.0.1:7890'; npm run dev
|
||
```
|
||
|
||
也可以在启动命令后追加代理参数:
|
||
|
||
```shell
|
||
$ node app.js --proxy=http://127.0.0.1:7890
|
||
```
|
||
|
||
## Vercel 部署
|
||
|
||
### 操作方法
|
||
|
||
1. fork 此项目
|
||
2. 在 Vercel 官网点击 `New Project`
|
||
3. 点击 `Import Git Repository` 并选择你 fork 的此项目并点击 `import`
|
||
4. 点击 `PERSONAL ACCOUNT` 的 `select`
|
||
5. 直接点 `Continue`
|
||
6. 若需要部署版本为概念版（不需要该步骤可以跳过），在 `Environment Variables` 添加 `key` 为 `platform`，`Value (Will Be Encrypted)` 为 `lite` 然后点击
|
||
`Add`
|
||
7. `PROJECT NAME`自己填,`FRAMEWORK PRESET` 选 `Other` 然后直接点 `Deploy` 接着等部署完成即可
|
||
|
||
## 功能特性
|
||
|
||
1. 登录
|
||
2. 刷新登录
|
||
3. 发送验证码
|
||
4. dfid 获取
|
||
5. 获取用户额外信息
|
||
6. 获取用户 vip 信息
|
||
7. 获取用户歌单
|
||
8. 获取用户关注歌手
|
||
9. 获取用户听歌历史排行
|
||
10. 获取用户最近听歌历史
|
||
11. 获取继续播放信息（对应手机版首页显示继续播放入口）
|
||
12. 收藏歌单/新建歌单
|
||
13. 取消收藏歌单/删除歌单
|
||
14. 对歌单添加歌曲
|
||
15. 对歌单删除歌曲
|
||
16. 新碟上架
|
||
17. 专辑信息
|
||
18. 专辑详情
|
||
19. 专辑音乐列表
|
||
20. 获取音乐 URL
|
||
21. 获取歌曲高潮部分
|
||
22. 搜索
|
||
23. 默认搜索关键词
|
||
24. 综合搜索
|
||
25. 热搜列表
|
||
26. 搜索建议
|
||
27. 歌词搜索
|
||
28. 获取歌词
|
||
29. 歌单分类
|
||
30. 歌单
|
||
31. 主题歌单
|
||
32. 音效歌单
|
||
33. 获取歌单详情
|
||
34. 获取歌单所有歌曲
|
||
35. 获取歌单所有歌曲（新版）
|
||
36. 相似歌单
|
||
37. 获取主题歌单所有歌曲
|
||
38. 获取主题音乐
|
||
39. 获取主题音乐详情
|
||
40. 歌曲推荐
|
||
41. 获取歌手和专辑图片
|
||
42. 获取歌手图片
|
||
43. 获取音乐相关信息
|
||
44. 获取更多音乐版本
|
||
45. 获取音乐伴奏信息
|
||
46. 获取音乐 k 歌数量
|
||
47. 获取音乐详情
|
||
48. 获取音乐专辑/歌手信息
|
||
49. 私人 FM(对应手机和 pc 端的猜你喜欢)
|
||
50. banner
|
||
51. 乐库 banner
|
||
52. 乐库电台
|
||
53. 乐库
|
||
54. 电台 - 推荐
|
||
55. 电台
|
||
56. 电台 - 图片
|
||
57. 电台 - 音乐列表
|
||
58. 编辑精选
|
||
59. 编辑精选数据
|
||
60. 编辑精选歌单
|
||
61. 编辑精选专区
|
||
62. 编辑精选专区详情
|
||
63. 领取 VIP（需要登陆，该接口为测试接口）
|
||
64. 获取歌手列表
|
||
65. 获取歌手详情
|
||
66. 获取歌手专辑
|
||
67. 获取歌手单曲
|
||
68. 获取歌手 MV
|
||
69. 关注歌手
|
||
70. 取消关注歌手
|
||
71. 获取关注歌手新歌
|
||
72. 获取视频 url
|
||
73. 获取歌曲 MV
|
||
74. 获取视频相关信息
|
||
75. 获取视频详情
|
||
76. 新歌速递
|
||
77. 场景音乐列表
|
||
78. 场景音乐详情
|
||
79. 获取场景音乐讨论区
|
||
80. 获取场景音乐模块 Tag
|
||
81. 获取场景音乐歌单列表
|
||
82. 获取场景音乐视频列表
|
||
83. 获取场景音乐音乐列表
|
||
84. 每日推荐
|
||
85. 历史推荐
|
||
86. 风格推荐
|
||
87. 排行列表
|
||
88. 排行榜推荐列表
|
||
89. 排行榜往期列表
|
||
90. 排行榜信息
|
||
91. 排行榜歌曲列表
|
||
92. 歌曲评论
|
||
93. 歌曲评论-根据分类返回
|
||
94. 歌曲评论-根据热词返回
|
||
95. 楼层评论
|
||
96. 歌单评论
|
||
97. 专辑评论
|
||
98. 歌曲曲谱
|
||
99. 曲谱详情
|
||
100. 推荐曲谱
|
||
101. 曲谱合集
|
||
102. 曲谱合集详情
|
||
103. 提交听歌历史
|
||
104. 获取服务器时间
|
||
105. 刷刷
|
||
106. AI 推荐
|
||
107. 频道 - 获取用户所有频道
|
||
108. 频道 - 详情
|
||
109. 频道 - 频道安利
|
||
110. 频道 - 相似频道
|
||
111. 频道 - 订阅
|
||
112. 频道 - 音乐故事
|
||
113. 频道 - 音乐故事详情
|
||
114. 动态 - 最常访问
|
||
115. 获取用户公开的音乐
|
||
116. 听书 - 每日推荐
|
||
117. 听书 - 排行榜推荐
|
||
118. 听书 - VIP 推荐
|
||
119. 听书 - 每周推荐
|
||
120. 听书 - 专辑详情
|
||
121. 听书 - 专辑音乐列表
|
||
122. 歌曲详情 - 歌曲成绩单
|
||
123. 歌曲详情 - 歌曲成绩单详情
|
||
124. 获取已购单曲
|
||
125. 获取已购专辑
|
||
|
||
## License
|
||
|
||
[The MIT License (MIT)](https://github.com/MakcRe/KuGouMusicApi/blob/main/LICENSE)
|