快速开始

hana-music-api 主要有两种用法：

在自己的项目里安装 SDK 后直接调用
启动一个 Bun HTTP 服务，对外提供接口

直接调用

先安装包：

bash

pnpm add hana-music-api

SDK 运行环境：

Node.js >=24
ESM 项目

标准调用方式是单例模式，先创建一个 client：

import { createHanaMusicApi } from 'hana-music-api'

export const hana = createHanaMusicApi({
  cookie: 'MUSIC_U=your-cookie',
})

const result = await hana.search({
  keywords: '周杰伦',
  limit: 5,
})

console.log(result.body)

如果只想调少量接口，也可以直接导入单个函数：

import { songUrl } from 'hana-music-api'

const result = await songUrl(
  {
    id: '347230',
  },
  {
    cookie: 'MUSIC_U=your-cookie',
  },
)

console.log(result.body)

如果模块名来自运行时字符串，可以用 invokeModule()：

import { invokeModule } from 'hana-music-api'

const result = await invokeModule(
  'user_account',
  {},
  {
    cookie: 'MUSIC_U=your-cookie',
  },
)

console.log(result.body)

配置怎么传

SDK 调用时业务参数和执行配置分开传：query 是接口的业务参数，config 放 cookie、proxy、fetcher 这类执行配置。详见编程式调用。

启动 HTTP 服务

如果想在自己服务器上部署服务，可以直接运行仓库里的 Bun 服务：

bash

bun install --frozen-lockfile
bun start

默认地址：

服务首页：http://127.0.0.1:3021/
文档：http://127.0.0.1:3021/docs
健康检查：http://127.0.0.1:3021/health

如果想要用 PM2 来集中管理 Node 进程，可以先全局安装 pm2：

bash

npm install -g pm2

然后直接通过 ecosystem.config.cjs 来启动 PM2 进程：

bash

pm2 start ecosystem.cjs

快速开始 ​

直接调用 ​

配置怎么传 ​

启动 HTTP 服务 ​

推荐阅读 ​

快速开始

直接调用

配置怎么传

启动 HTTP 服务

推荐阅读