@ikenxuan/amagi NPM

amagi

抖音、bilibili 的 web 端相关数据接口基于 Node.js 的实现。支持最低 node 版本为 v18 🚀

我是真爱粉 🧩

"amagi" /ˈæmədʒi/ 名称灵感来源于网络谐音梗，在网络上 BV1St41137jm / BV1DL411X7jE 上广泛传播。🎤💃

项目简介 📝

本项目最初的代码从 kkkkkk-10086 抽离。主要负责相关数据接口的封装。

amagi 将作为一个独立的上游模块，提供给下游 karin-plugin-kkk 和 kkkkkk-10086 进行视频解析相关业务使用。这两个项目已完成了几乎所有由 ikenxuan 安排的功能和任务，所以它们如果没有什么新的业务需求，本项目大概再也不会封装新的任何接口。

当然，如果你的下游有新的业务需求，欢迎提 issue 或 pr。（作者本人很菜，issue 不一定能解决）

安装/更新 📦

pnpm add @ikenxuan/amagi@latest

快速开始 🚀

基本用法 ✨

主要就两个方法，getDouyinData 和 getBilibiliData。

它接收三个参数，
第一个参数是对应平台封装好的数据接口名称
第二个参数是接口所需的参数
第三个参数是用户的 cookies。
得益于函数重载，参数二和参数三可以互换位置

你可以通过直接导入或者构造器创建实例。若通过构造器创建实例，就不需要传入 cookies 参数了，参数二默认接口所需参数。

import Client from '@ikenxuan/amagi'
// or
// import { getDouyinData, getBilibiliData } from '@ikenxuan/amagi'

// you can use it as a class/function/object
const amagi = Client({...options})
const amagi = new Client({...options})

// 使用示例
async function example() {
  // 获取抖音搜索数据
  const searchData = await amagi.getDouyinData(
    '搜索数据',
    { ...opt }
    )

  // 获取B站视频数据
  const videoData = await amagi.getBilibiliData(
    '单个视频作品数据',
    { ...opt }
    )

  console.log(searchData)
}

example()

Advanced

启动本地 HTTP 服务 🌐

import Client from '@ikenxuan/amagi'

const amagi = new Client({...options})

// 启动本地服务，默认端口 4567
const app = amagi.startClient()
// 或指定端口
// const app = amagi.startClient(8080)

启动后可通过以下路径访问 API：

抖音 API: http://localhost:4567/api/douyin/... 📱
bilibili API: http://localhost:4567/api/bilibili/... 📺

API 文档: https://amagi.apifox.cn 📝

平台功能模块 🧩

PS: 以下功能模块的使用方法与上述基本用法类似，我也不知道为什么要写这个。。。

抖音功能模块 📱

抖音相关功能模块提供了一系列工具和 API 接口，用于获取抖音平台的数据。

import { douyinUtils } from '@ikenxuan/amagi'

// 使用签名算法
const mstoken = douyinUtils.sign.Mstoken(107)
const verifyFp = douyinUtils.sign.VerifyFpManager()
const abSign = douyinUtils.sign.AB('需要签名的地址')

// 使用 API 接口
const videoData = await douyinUtils.api.getWorkInfo(
  { ...opt },
  'cookies'
)

const userInfo = await douyinUtils.api.getUserProfile(
  { ...opt },
  'cookies'
)

// 直接获取数据
const searchResult = await douyinUtils.getDouyinData(
  '搜索数据',
  { ...opt }
  )

主要功能：

📹 视频/图集作品数据获取
👤 用户信息获取
💬 评论数据获取
🔍 搜索功能
🎬 直播间信息
🎵 音乐数据
😄 表情数据

bilibili 功能模块 📺

bilibili 相关功能模块提供了获取 bilibili 平台数据的工具和 API。

import { bilibiliUtils } from '@ikenxuan/amagi'

// 获取视频信息
const videoInfo = await bilibiliUtils.api.getVideoInfo({ ...opt })

// 获取评论数据
const comments = await bilibiliUtils.api.getComments({ ...opt })

// 直接获取数据
const userInfo = await bilibiliUtils.getBilibiliData(
  '用户主页数据',
  { ...opt }
  )

主要功能：