尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

music-api 音乐解析工具:5 分钟打通网易云、QQ、酷狗、酷我四平台播放地址

music-api 音乐解析工具:5 分钟打通网易云、QQ、酷狗、酷我四平台播放地址 music-api 音乐解析工具5 分钟打通网易云、QQ、酷狗、酷我四平台播放地址【免费下载链接】music-apiMusic API项目地址: https://gitcode.com/gh_mirrors/mu/music-api音乐开发者的日子常常很难歌只有一首版权却分散在好几家平台。music-api 是一个用 PHP 编写的音乐解析工具它用统一接口同时覆盖网易云、QQ 音乐、酷狗、酷我四个平台一个请求就能拿到歌曲播放地址帮助你快速集成多平台音乐能力。先从一次找歌失败说起我去年给朋友的博客做了个每日推荐歌曲小插件需求很简单每天自动挑一首歌塞进页面播放器里。开工后才发现事情远没有想象中顺利网易云的热门歌QQ 音乐未必有版权就算搜到歌官方接口也未必直接给播放地址四个平台四套文档、四套参数、四种返回格式光对接就是一场持久战。那段时间我每天在四个平台之间来回切换边查文档边调试效率低得让人想摔键盘。直到我偶然翻到 music-api 这个开源项目才真正把这件事从折腾变成了十分钟搞定。第一站认识 music-api 这个纯 PHP 音乐解析工具music-api 的定位很纯粹——把各平台搜歌 取播放地址的复杂过程封装成最朴素的 HTTP 接口。它不依赖框架、不引入 composer 包整个项目就是四个独立的 PHP 文件music-api/ ├── netease.php # 网易云音乐解析 ├── qq.php # QQ 音乐解析 ├── kugou.php # 酷狗音乐解析 └── kuwo.php # 酷我音乐解析四个文件互不依赖各管各的平台。任何一个平台出了问题删掉或替换对应文件即可完全不影响其他平台继续工作。一张图看清它能给你什么你想要的东西可用文件说明关键词搜索歌曲全部四个文件返回曲名、歌手、时长、封面等基础信息直接拿某首歌的播放直链全部四个文件列表里传入序号或按歌曲 ID 直接解析解析整个歌单netease.php传入歌单 ID可遍历歌单内全部曲目歌单内随机抽一首歌netease.php非常适合每日推荐这类场景解析 MV 视频地址kugou.php、kuwo.php歌曲之外的视频资源也能一并搞定封面图、播放量、评论数等附加信息酷狗 / 酷我等做展示页时很有用对比下来你会发现它把找歌和拿链接这两个最磨人的环节都替你扛了下来而你要做的只是对着 URL 敲几个参数。第二站10 分钟跑通第一个接口上手门槛低到什么程度只要你的服务器上有 PHP 环境建议 7.0 以上并开启了 curl 扩展就能跑起来。第一步获取代码git clone https://gitcode.com/gh_mirrors/mu/music-api第二步部署把克隆下来的四个 PHP 文件放进网站的任意目录即可。它们不依赖数据库、不需要额外配置放到public、www等站点根目录下就能被直接访问。第三步发起第一次请求部署完成后在浏览器里访问这样一个地址http://你的域名/netease.php?msg晴天count5页面会立刻返回一段 JSON{ code: 200, text: 解析成功, type: 歌曲解析, now: 2026-08-13 13:05:43, data: [ { id: 186016, name: 晴天, singername: 周杰伦 } ] }到这里你的第一个音乐接口就已经上线了。整个过程只需要三步克隆、放文件、敲 URL。第三站读懂参数把四种玩法全部解锁四个文件的接口风格高度一致核心参数只有几个学一次就能全部掌握参数含义默认值msg要搜索的歌名或 MV 名称无必填type解析类型见下表songn列表中的序号填了就直接返回对应歌曲的播放地址空只返回列表count单页返回条数网易云 / 酷狗 10 条QQ / 酷我 20 条page页码1而type参数在不同文件里还各有扩展玩法type 取值作用适用文件song按关键词搜索歌曲全部songid按歌曲 ID 直出播放地址网易云、QQrandom从歌单里随机抽一首网易云mv按关键词搜索 MV酷狗、酷我rid/mid按歌曲 / MV 的 ID 直出地址酷我shash/mhash按 hash 直出歌曲 / MV 地址酷狗举个组合例子想从网易云热歌榜里随机挑一首歌只需要http://你的域名/netease.php?typerandom不传id时它默认解析热歌榜传了歌单 ID 就解析指定歌单。一个参数换来每日随机好歌这种设计对新手非常友好。第四站放进真实项目这两个场景最实用场景一给个人网站加一个每日一歌模块做法很简单用一个定时任务每天调用一次netease.php?typerandom把返回的歌曲地址存下来前端页面加载时直接播放即可。// 每天定时执行一次把推荐歌曲写进文件 $json file_get_contents(http://你的域名/netease.php?typerandom); file_put_contents(daily_song.json, $json);这样用户每次打开网站都能听到一首来自热歌榜的随机好歌实现成本几乎为零。场景二搭建门店 / 公司内部的点歌后台门店背景音乐、公司茶歇区点歌台这类需求往往要覆盖多个平台的曲库。把 kugou.php 和 kuwo.php 部署在服务端后后台只需一个搜索框员工输入歌名 → 调用酷狗、酷我两个接口同时搜索前端拿到结果列表选中后即可播放或投屏到店内音响想放 MV 大屏展示切到typemv就能拿到视频地址。由于四个接口返回的都是标准 JSON 且已开启跨域头前端 JS 直接请求也完全没问题省掉了写中转代理的麻烦。第五站新手最容易踩的四个坑1. 付费歌曲拿不到播放地址这是版权限制不是 bug。遇到付费歌曲时接口会返回付费歌曲暂时无法获取歌曲下载链接之类的提示调用方记得做好兜底提示别让用户看到一串报错。2. 接口偶尔会失灵各平台会不定期调整接口策略某个文件可能在某天突然解析失败。这是所有第三方解析类项目的共性处理方式是关注项目更新及时同步最新代码。3. 请求太频繁容易被平台限制音乐平台普遍有反爬机制。生产环境务必控制调用频率不要在前端每加载一次页面就去请求一次接口合理做法是加缓存或定时更新。4. 服务器环境缺组件部署时如果报 curl 相关错误说明 PHP 环境没装 curl 扩展。确认php -m输出里有 curl 即可多数云主机的 PHP 镜像默认自带。第六站从能用到好用的四个进阶思路跑通只是开始想让这套接口真正稳得住、用得好可以按下面四个方向逐步升级结果缓存降低平台压力搜索类接口的结果短期内变化不大可以把返回的 JSON 缓存几分钟甚至几小时大幅减少对平台的实际请求量。多平台接力搜索提升命中率在一个平台搜不到的歌自动换下一个平台再试。比如先把网易云的结果返回给用户若无版权则依次尝试 QQ、酷狗、酷我把找不到的概率压到最低。定时任务维护热门榜单网易云的random接口天然适合配合 cron 定时拉取热歌榜做成每日歌单适合做推荐类产品。参照现有模式扩展新平台想接入新的音乐平台时照着kugou.php的骨架写一个新文件即可——先找搜索接口、再解析返回数据、最后统一输出 JSON。模块化结构让二次开发成本低得惊人。终点站现在就可以动手回顾这次旅程music-api 真正打动我的有三点简单纯 PHP、无依赖、三个步骤上线新手也能顺利跑通统一四个平台的差异被全部抹平一个参数模型走天下可拆每个平台独立成文件维护、取舍、扩展都极其灵活。如果你正在做音乐相关的网站、小程序或后台系统别再在四个平台的文档里来回折腾了。下一步行动清单克隆代码并部署到你的 PHP 环境先跑通netease.php?msg晴天感受一下返回格式尝试用typerandom做一版每日推荐小功能熟悉后再决定接入哪些平台逐步构建你的多平台音乐聚合能力好的工具不一定要多复杂能把最麻烦的事情变得简单就是它最大的价值。现在就打开终端试试吧。【免费下载链接】music-apiMusic API项目地址: https://gitcode.com/gh_mirrors/mu/music-api创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表