miguMusic-api-enhanced

项目概述

migu-api-enhanced 是一个基于 Hono 框架的咪咕音乐 API 服务，参考了同类开源音乐 API 项目的做法。它把搜索、专辑、歌单、歌手、播放地址、推荐、MV、演唱会、视频、用户与登录等能力整理成一百二十多个接口，可部署到 Node.js、Bun、Deno 与 Cloudflare Workers，也能作为 NPM 包被其他项目引用。

一套统一的接口，把咪咕音乐的数据能力接出来。

主要功能

• 搜索：歌曲、歌单、歌手、专辑、MV、歌词、短视频、彩铃、演唱会与票务，含热门搜索与搜索建议
• 播放地址：多版本播放地址接口、咪咕云盘与下载接口
• 歌单与歌手：歌单广场、电台歌曲、匹配外部歌单，以及歌手歌曲、专辑、相似歌手与情书
• 推荐与栏目：歌曲与歌单推荐、相似歌曲、畅听模式，以及排行榜、新歌速递、新碟上架
• MV 与演唱会：MV 详情、推荐与播放地址，演唱会信息、评论与推荐 MV
• 用户体系：个人信息、我喜欢、收藏、自建歌单管理、听歌排行与消息互动
• 登录认证：手机号登录、短信登录、一键登录与帐密登录
• 资源处理：歌词获取、可听性检查，以及翻译歌词与加密歌词解密

适用人群

• 想搭建第三方音乐服务的开发者
• 需要在应用中接入咪咕音乐数据的团队
• 研究音乐平台接口与签名机制的开发者
• 想用 NPM 包快速调用音乐接口的前端项目

快速上手

1. 安装依赖：pnpm install --registry=https://registry.npmmirror.com
2. 本地开发：Node.js 环境执行 pnpm run dev，Bun 环境执行 pnpm run start:bun --watch
3. 生产部署：先执行 pnpm run build:node 再执行 pnpm start
4. 作为 NPM 包使用：pnpm add migu-api-enhanced，用命名导入调用具体接口
5. 部署细节与环境变量参考仓库中的部署文档

核心优势

• 接口齐全：覆盖一百二十多个接口，常见音乐业务基本无需自研
• 部署灵活：同一套代码可跑在 Node.js、Bun、Deno 与 Cloudflare Workers
• 类型友好：同时打包为支持 ESM 与 CJS 的 NPM 包，并附带 TypeScript 类型声明
• 工具函数可复用：设备号、音质转换与歌词解密等工具函数可单独引用

系统要求

项目	要求
运行环境	Node.js 18 及以上，或 Bun、Deno、Cloudflare Workers
包管理	pnpm
网络	可访问咪咕音乐接口

注意事项

• 项目仅供学习与研究使用，不得用于商业用途
• 通过非官方接口获取数据，与咪咕音乐官方无任何关联
• 音视频资源版权归咪咕音乐所有，请支持正版
• 请勿用于大规模爬取、侵犯他人权益或其他违法用途