From 0ba4e8af26c58e8886fea045c3b6a802d0e11515 Mon Sep 17 00:00:00 2001 From: Lines Date: Wed, 17 Jul 2024 15:10:09 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20=E6=90=9C=E7=B4=A2?= =?UTF-8?q?=E5=BB=BA=E8=AE=AE=E6=8E=A5=E5=8F=A3=20=EF=BC=8C#27?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 179 ++++++++++++++++++----------------- docs/README.md | 199 +++++++++++++++++++++------------------ module/search_suggest.js | 17 ++++ package.json | 2 +- 4 files changed, 217 insertions(+), 180 deletions(-) create mode 100644 module/search_suggest.js diff --git a/README.md b/README.md index 571297f..87912e8 100644 --- a/README.md +++ b/README.md @@ -138,95 +138,96 @@ $ $Env:HOST=127.0.0.1; npm run dev 22. 默认搜索关键词 23. 综合搜索 24. 热搜列表 -25. 歌词搜索 -26. 获取歌词 -27. 歌单分类 -28. 歌单 -29. 主题歌单 -30. 音效歌单 -31. 获取歌单详情 -32. 获取歌单所有歌曲 -33. 获取歌单所有歌曲（新版） -34. 相似歌单 -35. 获取主题歌单所有歌曲 -36. 获取主题音乐 -37. 获取主题音乐详情 -38. 歌曲推荐 -39. 获取歌手和专辑图片 -40. 获取歌手图片 -41. 获取音乐相关信息 -42. 获取音乐详情 -43. 获取音乐专辑/歌手信息 -44. 私人 FM(对应手机和 pc 端的猜你喜欢) -45. banner -46. 乐库 banner -47. 乐库电台 -48. 乐库 -49. 电台 - 推荐 -50. 电台 -51. 电台 - 图片 -52. 电台 - 音乐列表 -53. 编辑精选 -54. 编辑精选数据 -55. 编辑精选歌单 -56. 编辑精选专区 -57. 编辑精选专区详情 -58. 领取 VIP（需要登陆，该接口为测试接口） -59. 获取歌手列表 -60. 获取歌手详情 -61. 获取歌手专辑 -62. 获取歌手单曲 -63. 获取歌手 MV -64. 获取视频 url -65. 获取歌曲 MV -66. 获取视频相关信息 -67. 获取视频详情 -68. 新歌速递 -69. 场景音乐列表 -70. 场景音乐详情 -71. 获取场景音乐讨论区 -72. 获取场景音乐模块 Tag -73. 获取场景音乐歌单列表 -74. 获取场景音乐视频列表 -75. 获取场景音乐音乐列表 -76. 每日推荐 -77. 历史推荐 -78. 风格推荐 -79. 排行列表 -80. 排行榜推荐列表 -81. 排行榜往期列表 -82. 排行榜信息 -83. 排行榜歌曲列表 -84. 歌曲评论 -85. 歌曲评论-根据分类返回 -86. 歌曲评论-根据热词返回 -87. 楼层评论 -88. 歌单评论 -89. 专辑评论 -90. 歌曲曲谱 -91. 曲谱详情 -92. 推荐曲谱 -93. 曲谱合集 -94. 曲谱合集详情 -95. 提交听歌历史 -96. 获取服务器时间 -97. 刷刷 -98. AI 推荐 -99. 频道 - 获取用户所有频道 -100. 频道 - 详情 -101. 频道 - 频道安利 -102. 频道 - 相似频道 -103. 频道 - 订阅 -104. 频道 - 音乐故事 -105. 频道 - 音乐故事详情 -106. 动态 - 最常访问 -107. 获取用户公开的音乐 -108. 听书 - 每日推荐 -109. 听书 - 排行榜推荐 -110. 听书 - VIP 推荐 -111. 听书 - 每周推荐 -112. 听书 - 专辑详情 -113. 听书 - 专辑音乐列表 +25. 搜索建议 +26. 歌词搜索 +27. 获取歌词 +28. 歌单分类 +29. 歌单 +30. 主题歌单 +31. 音效歌单 +32. 获取歌单详情 +33. 获取歌单所有歌曲 +34. 获取歌单所有歌曲（新版） +35. 相似歌单 +36. 获取主题歌单所有歌曲 +37. 获取主题音乐 +38. 获取主题音乐详情 +39. 歌曲推荐 +40. 获取歌手和专辑图片 +41. 获取歌手图片 +42. 获取音乐相关信息 +43. 获取音乐详情 +44. 获取音乐专辑/歌手信息 +45. 私人 FM(对应手机和 pc 端的猜你喜欢) +46. banner +47. 乐库 banner +48. 乐库电台 +49. 乐库 +50. 电台 - 推荐 +51. 电台 +52. 电台 - 图片 +53. 电台 - 音乐列表 +54. 编辑精选 +55. 编辑精选数据 +56. 编辑精选歌单 +57. 编辑精选专区 +58. 编辑精选专区详情 +59. 领取 VIP（需要登陆，该接口为测试接口） +60. 获取歌手列表 +61. 获取歌手详情 +62. 获取歌手专辑 +63. 获取歌手单曲 +64. 获取歌手 MV +65. 获取视频 url +66. 获取歌曲 MV +67. 获取视频相关信息 +68. 获取视频详情 +69. 新歌速递 +70. 场景音乐列表 +71. 场景音乐详情 +72. 获取场景音乐讨论区 +73. 获取场景音乐模块 Tag +74. 获取场景音乐歌单列表 +75. 获取场景音乐视频列表 +76. 获取场景音乐音乐列表 +77. 每日推荐 +78. 历史推荐 +79. 风格推荐 +80. 排行列表 +81. 排行榜推荐列表 +82. 排行榜往期列表 +83. 排行榜信息 +84. 排行榜歌曲列表 +85. 歌曲评论 +86. 歌曲评论-根据分类返回 +87. 歌曲评论-根据热词返回 +88. 楼层评论 +89. 歌单评论 +90. 专辑评论 +91. 歌曲曲谱 +92. 曲谱详情 +93. 推荐曲谱 +94. 曲谱合集 +95. 曲谱合集详情 +96. 提交听歌历史 +97. 获取服务器时间 +98. 刷刷 +99. AI 推荐 +100. 频道 - 获取用户所有频道 +101. 频道 - 详情 +102. 频道 - 频道安利 +103. 频道 - 相似频道 +104. 频道 - 订阅 +105. 频道 - 音乐故事 +106. 频道 - 音乐故事详情 +107. 动态 - 最常访问 +108. 获取用户公开的音乐 +109. 听书 - 每日推荐 +110. 听书 - 排行榜推荐 +111. 听书 - VIP 推荐 +112. 听书 - 每周推荐 +113. 听书 - 专辑详情 +114. 听书 - 专辑音乐列表 ## License diff --git a/docs/README.md b/docs/README.md index 14decd9..186f9e3 100644 --- a/docs/README.md +++ b/docs/README.md @@ -51,95 +51,96 @@ 22. [`默认搜索关键词`](#默认搜索关键词) 23. [`综合搜索`](#综合搜索) 24. [`热搜列表`](#热搜列表) -25. [`歌词搜索`](#歌词搜索) -26. [`获取歌词`](#获取歌词) -27. [`歌单分类`](#歌单分类) -28. [`歌单`](#歌单) -29. [`主题歌单`](#主题歌单) -30. [`音效歌单`](#音效歌单) -31. [`获取歌单详情`](#获取歌单详情) -32. [`获取歌单所有歌曲`](#获取歌单所有歌曲) -33. [`获取歌单所有歌曲（新版）`](#获取歌单所有歌曲新版) -34. [`相似歌单`](#相似歌单) -35. [`获取主题歌单所有歌曲`](#获取主题歌单所有歌曲) -36. [`获取主题音乐`](#获取主题音乐) -37. [`获取主题音乐详情`](#获取主题音乐详情) -38. [`歌曲推荐`](#歌曲推荐) -39. [`获取歌手和专辑图片`](#获取歌手和专辑图片) -40. [`获取歌手图片`](#获取歌手图片) -41. [`获取音乐相关信息`](#获取音乐相关信息) -42. [`获取音乐详情`](#获取音乐详情) -43. [`获取音乐专辑/歌手信息`](#获取音乐专辑/歌手信息) -44. [`私人 FM(对应手机和 pc 端的猜你喜欢)`](#私人-fm对应手机和-pc-端的猜你喜欢) -45. [`banner`](#banner) -46. [`乐库 banner`](#乐库-banner) -47. [`乐库电台`](#乐库电台) -48. [`乐库`](#乐库) -49. [`电台 - 推荐`](#电台---推荐) -50. [`电台`](#电台) -51. [`电台 - 图片`](#电台---图片) -52. [`电台 - 音乐列表`](#电台---音乐列表) -53. [`编辑精选`](#编辑精选) -54. [`编辑精选数据`](#编辑精选数据) -55. [`编辑精选歌单`](#编辑精选歌单) -56. [`编辑精选专区`](#编辑精选专区) -57. [`编辑精选专区详情`](#编辑精选专区详情) -58. [`领取 VIP（需要登陆，该接口为测试接口）`](#领取-vip需要登陆该接口为测试接口) -59. [`获取歌手列表`](#获取歌手列表) -60. [`获取歌手详情`](#获取歌手详情) -61. [`获取歌手专辑`](#获取歌手专辑) -62. [`获取歌手单曲`](#获取歌手单曲) -63. [`获取歌手 MV`](#获取歌手-MV) -64. [`获取视频 url`](#获取视频-ur) -65. [`获取歌曲 MV`](#获取歌曲-MV) -66. [`获取视频相关信息`](#获取视频相关信息) -67. [`获取视频详情`](#获取视频详情) -68. [`新歌速递`](#新歌速递) -69. [`场景音乐列表`](#场景音乐列表) -70. [`场景音乐详情`](#场景音乐详情) -71. [`获取场景音乐讨论区`](#获取场景音乐讨论区) -72. [`获取场景音乐模块 Tag`](#获取场景音乐模块) -73. [`获取场景音乐歌单列表`](#获取场景音乐歌单列表) -74. [`获取场景音乐视频列表`](#获取场景音乐视频列表) -75. [`获取场景音乐音乐列表`](#获取场景音乐音乐列表) -76. [`每日推荐`](#每日推荐) -77. [`历史推荐`](#历史推荐) -78. [`风格推荐`](#风格推荐) -79. [`排行列表`](#排行列表) -80. [`排行榜推荐列表`](#排行榜推荐列表) -81. [`排行榜往期列表`](#排行榜往期列表) -82. [`排行榜信息`](#排行榜信息) -83. [`排行榜歌曲列表`](#排行榜歌曲列表) -84. [`歌曲评论`](#歌曲评论) -85. [`歌曲评论-根据分类返回`](#歌曲评论-根据分类返回) -86. [`歌曲评论-根据热词返回`](#歌曲评论-根据热词返回) -87. [`楼层评论`](#楼层评论) -88. [`歌单评论`](#歌单评论) -89. [`专辑评论`](#专辑评论) -90. [`歌曲曲谱`](#歌曲曲谱) -91. [`曲谱详情`](#曲谱详情) -92. [`推荐曲谱`](#推荐曲谱) -93. [`曲谱合集`](#曲谱合集) -94. [`曲谱合集详情`](#曲谱合集详情) -95. [`提交听歌历史`](#提交听歌历史) -96. [`获取服务器时间`](#获取服务器时间) -97. [`刷刷`](#刷刷) -98. [`AI 推荐`](#ai-推荐) -99. [`频道 - 获取用户所有频道`](#频道---获取用户所有频道) -100. [`频道 - 详情`](#频道---详情) -101. [`频道 - 频道安利`](#频道---频道安利) -102. [`频道 - 相似频道`](#频道---相似频道) -103. [`频道 - 订阅`](#频道---订阅) -104. [`频道 - 音乐故事`](#频道---音乐故事) -105. [`频道 - 音乐故事详情`](#频道---音乐故事详情) -106. [`动态 - 最常访问`](#动态---最常访问) -107. [`获取用户公开的音乐`](#获取用户公开的音乐) -108. [`听书 - 每日推荐`](#听书---每日推荐) -109. [`听书 - 排行榜推荐`](#听书---排行榜推荐) -110. [`听书 - VIP 推荐`](#听书---vip-推荐) -111. [`听书 - 每周推荐`](#听书---每周推荐) -112. [`听书 - 专辑详情`](#听书---专辑详情) -113. [`听书 - 专辑音乐列表`](#听书---专辑音乐列表) +25. [`搜索建议`](#搜索建议) +26. [`歌词搜索`](#歌词搜索) +27. [`获取歌词`](#获取歌词) +28. [`歌单分类`](#歌单分类) +29. [`歌单`](#歌单) +30. [`主题歌单`](#主题歌单) +31. [`音效歌单`](#音效歌单) +32. [`获取歌单详情`](#获取歌单详情) +33. [`获取歌单所有歌曲`](#获取歌单所有歌曲) +34. [`获取歌单所有歌曲（新版）`](#获取歌单所有歌曲新版) +35. [`相似歌单`](#相似歌单) +36. [`获取主题歌单所有歌曲`](#获取主题歌单所有歌曲) +37. [`获取主题音乐`](#获取主题音乐) +38. [`获取主题音乐详情`](#获取主题音乐详情) +39. [`歌曲推荐`](#歌曲推荐) +40. [`获取歌手和专辑图片`](#获取歌手和专辑图片) +41. [`获取歌手图片`](#获取歌手图片) +42. [`获取音乐相关信息`](#获取音乐相关信息) +43. [`获取音乐详情`](#获取音乐详情) +44. [`获取音乐专辑/歌手信息`](#获取音乐专辑/歌手信息) +45. [`私人 FM(对应手机和 pc 端的猜你喜欢)`](#私人-fm对应手机和-pc-端的猜你喜欢) +46. [`banner`](#banner) +47. [`乐库 banner`](#乐库-banner) +48. [`乐库电台`](#乐库电台) +49. [`乐库`](#乐库) +50. [`电台 - 推荐`](#电台-推荐) +51. [`电台`](#电台) +52. [`电台 - 图片`](#电台-图片) +53. [`电台 - 音乐列表`](#电台-音乐列表) +54. [`编辑精选`](#编辑精选) +55. [`编辑精选数据`](#编辑精选数据) +56. [`编辑精选歌单`](#编辑精选歌单) +57. [`编辑精选专区`](#编辑精选专区) +58. [`编辑精选专区详情`](#编辑精选专区详情) +59. [`领取 VIP（需要登陆，该接口为测试接口）`](#领取-vip需要登陆该接口为测试接口) +60. [`获取歌手列表`](#获取歌手列表) +61. [`获取歌手详情`](#获取歌手详情) +62. [`获取歌手专辑`](#获取歌手专辑) +63. [`获取歌手单曲`](#获取歌手单曲) +64. [`获取歌手 MV`](#获取歌手-MV) +65. [`获取视频 url`](#获取视频-ur) +66. [`获取歌曲 MV`](#获取歌曲-MV) +67. [`获取视频相关信息`](#获取视频相关信息) +68. [`获取视频详情`](#获取视频详情) +69. [`新歌速递`](#新歌速递) +70. [`场景音乐列表`](#场景音乐列表) +71. [`场景音乐详情`](#场景音乐详情) +72. [`获取场景音乐讨论区`](#获取场景音乐讨论区) +73. [`获取场景音乐模块 Tag`](#获取场景音乐模块) +74. [`获取场景音乐歌单列表`](#获取场景音乐歌单列表) +75. [`获取场景音乐视频列表`](#获取场景音乐视频列表) +76. [`获取场景音乐音乐列表`](#获取场景音乐音乐列表) +77. [`每日推荐`](#每日推荐) +78. [`历史推荐`](#历史推荐) +79. [`风格推荐`](#风格推荐) +80. [`排行列表`](#排行列表) +81. [`排行榜推荐列表`](#排行榜推荐列表) +82. [`排行榜往期列表`](#排行榜往期列表) +83. [`排行榜信息`](#排行榜信息) +84. [`排行榜歌曲列表`](#排行榜歌曲列表) +85. [`歌曲评论`](#歌曲评论) +86. [`歌曲评论-根据分类返回`](#歌曲评论-根据分类返回) +87. [`歌曲评论-根据热词返回`](#歌曲评论-根据热词返回) +88. [`楼层评论`](#楼层评论) +89. [`歌单评论`](#歌单评论) +90. [`专辑评论`](#专辑评论) +91. [`歌曲曲谱`](#歌曲曲谱) +92. [`曲谱详情`](#曲谱详情) +93. [`推荐曲谱`](#推荐曲谱) +94. [`曲谱合集`](#曲谱合集) +95. [`曲谱合集详情`](#曲谱合集详情) +96. [`提交听歌历史`](#提交听歌历史) +97. [`获取服务器时间`](#获取服务器时间) +98. [`刷刷`](#刷刷) +99. [`AI 推荐`](#ai-推荐) +100. [`频道 - 获取用户所有频道`](#频道-获取用户所有频道) +101. [`频道 - 详情`](#频道---详情) +102. [`频道 - 频道安利`](#频道-频道安利) +103. [`频道 - 相似频道`](#频道-相似频道) +104. [`频道 - 订阅`](#频道-订阅) +105. [`频道 - 音乐故事`](#频道-音乐故事) +106. [`频道 - 音乐故事详情`](#频道-音乐故事详情) +107. [`动态 - 最常访问`](#动态-最常访问) +108. [`获取用户公开的音乐`](#获取用户公开的音乐) +109. [`听书 - 每日推荐`](#听书-每日推荐) +110. [`听书 - 排行榜推荐`](#听书-排行榜推荐) +111. [`听书 - VIP 推荐`](#听书-vip-推荐) +112. [`听书 - 每周推荐`](#听书-每周推荐) +113. [`听书 - 专辑详情`](#听书-专辑详情) +114. [`听书 - 专辑音乐列表`](#听书-专辑音乐列表) ### 安装 @@ -248,6 +249,8 @@ $ set HOST=127.0.0.1 && npm run dev #### 更新记录 +24-07-17: 添加 搜索建议 接口。 + 24-07-14: 添加 频道、听书等多个接口。 24-07-14: 添加 刷刷、AI 推荐 接口，更新 提交听歌历史 接口。 @@ -759,7 +762,23 @@ fileids: 歌单中歌曲的 fileid，可多个,用逗号隔开 **调用例子：** `/search/hot` -调用例子 : /search/hot +### 搜索建议 + +说明 : 调用此接口 , 传入搜索关键词可获得搜索建议 , 搜索结果同时包含单曲 , 歌手 , 歌单信息 + +**可选参数：** + +`albumTipCount `: 专辑返回数量 + +`correctTipCount `: 目前未知，可能是歌单 + +`mvTipCount `: MV 返回数量 + +`musicTipCount `: 音乐返回数量 + +**接口地址：** `/search/suggest` + +**调用例子：** `/search/suggest?keywords=海阔天空` ### 歌词搜索 diff --git a/module/search_suggest.js b/module/search_suggest.js new file mode 100644 index 0000000..9f269c5 --- /dev/null +++ b/module/search_suggest.js @@ -0,0 +1,17 @@ +module.exports = (params, useAxios) => { + return useAxios({ + url: '/v2/getSearchTip', + method: 'GET', + params: { + keyword: params.keywords, + AlbumTipCount: params.albumTipCount || 10, + CorrectTipCount: params.correctTipCount || 10, + MVTipCount: params.mvTipCount || 10, + MusicTipCount: params.musicTipCount || 10, + radiotip: 1 + }, + encryptType: 'android', + cookie: params?.cookie || {}, + headers: { 'x-router': 'searchtip.kugou.com' }, + }); +}; diff --git a/package.json b/package.json index 337b68a..598f93d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "kugoumusicapi", - "version": "1.3.0", + "version": "1.3.1", "description": "", "main": "main.js", "bin": "./app.js",