miguMusic-api-enhanced

Project Overview

migu-api-enhanced is a Migu Music API service built on the Hono framework, inspired by similar open-source music API projects. It organizes search, albums, playlists, artists, playback URLs, recommendations, MVs, concerts, videos, users, and login into more than 120 endpoints, deployable to Node.js, Bun, Deno, and Cloudflare Workers, and usable as an NPM package by other projects.

A unified set of endpoints that exposes Migu Music's data.

Key Features

• Search: songs, playlists, artists, albums, MVs, lyrics, short videos, ringtones, concerts, and ticketing, with hot searches and suggestions
• Playback URLs: multiple URL endpoint versions plus Migu cloud drive and download endpoints
• Playlists and artists: playlist square, radio songs, external playlist matching, plus artist songs, albums, similar artists, and fan letters
• Recommendations and sections: song and playlist recommendations, similar songs, and listening mode, plus charts, new releases, and new albums
• MVs and concerts: MV details, recommendations, and URLs, plus concert info, comments, and recommended MVs
• User system: profile, my favorites, collections, custom playlist management, listening rankings, and messaging
• Login and auth: phone login, SMS login, one-tap login, and account/password login
• Resource handling: lyric fetching, listenability checks, and translation/encrypted lyric decryption

Target Audience

• Developers building third-party music services
• Teams integrating Migu Music data into apps
• Developers studying music platform APIs and signing
• Frontend projects wanting quick music API access via NPM

Quick Start

1. Install dependencies: pnpm install --registry=https://registry.npmmirror.com
2. Local dev: pnpm run dev on Node.js, or pnpm run start:bun --watch on Bun
3. Production: run pnpm run build:node then pnpm start
4. As an NPM package: pnpm add migu-api-enhanced and call specific endpoints via named imports
5. See the deployment docs in the repo for details and environment variables

Core Advantages

• Comprehensive endpoints: 120+ endpoints cover most music use cases without custom work
• Flexible deployment: one codebase runs on Node.js, Bun, Deno, and Cloudflare Workers
• Type friendly: published as an ESM and CJS NPM package with TypeScript declarations
• Reusable utilities: helpers for device IDs, quality conversion, and lyric decryption can be imported alone

System Requirements

Item	Requirement
Runtime	Node.js 18+, or Bun, Deno, Cloudflare Workers
Package manager	pnpm
Network	Access to Migu Music endpoints

Notes

• The project is for learning and research only and must not be used commercially
• Data comes from unofficial endpoints and is unrelated to Migu Music official
• Audio and video copyright belongs to Migu Music; support the legitimate service
• Do not use it for large-scale scraping, infringing others' rights, or other unlawful purposes