HTTP 服务
使用 amagi 启动本地 HTTP 服务
HTTP 服务
amagi 内置了 Express 服务器，可以一键启动本地 HTTP 服务。
启动服务
import amagi from '@ikenxuan/amagi'
const client = amagi({
cookies: {
bilibili: 'SESSDATA=xxx; bili_jct=yyy',
douyin: 'ttwid=...',
kuaishou: 'did=...',
xiaohongshu: 'a1=...'
}
})
// 启动服务，默认端口 4567
client.startServer(4567)启动后访问：
- 根路径
/会重定向到 API 文档 - API 文档：https://amagi.apifox.cn
路由结构
所有 API 路由挂载在 /api/<platform> 下：
/api/douyin/*- 抖音相关接口/api/bilibili/*- B站相关接口/api/kuaishou/*- 快手相关接口/api/xiaohongshu/*- 小红书相关接口
平台路由
| 路由 | 说明 | 参数 | |------|------|------| | GET /fetch_one_work | 聚合解析 | aweme_id | | GET /fetch_work_comments | 评论数据
| aweme_id, number?, cursor? | | GET /fetch_user_info | 用户主页数据 | sec_uid | | GET /fetch_user_post_videos |
用户视频列表 | sec_uid | | GET /fetch_search_info | 搜索数据 | query, number?, search_id? | | GET /fetch_suggest_words |
热点词数据 | query, number? | | GET /fetch_music_work | 音乐数据 | music_id | | GET /fetch_emoji_list | Emoji 列表 | - | |
GET /fetch_emoji_pro_list | 动态表情列表 | - | | GET /fetch_user_live_videos | 直播间信息 | sec_uid | | GET /fetch_video_comment_replies | 评论回复 | aweme_id, comment_id, number?, cursor? | | GET /fetch_work_danmaku | 弹幕数据 |
aweme_id, duration, start_time?, end_time? |
响应格式
所有接口返回统一的 JSON 格式：
{
"success": true,
"code": 200,
"message": "获取成功",
"data": { ... },
"requestPath": "/api/bilibili/fetch_one_video?bvid=BV1xx411c7mD"
}自定义路由
你也可以单独注册平台路由到自己的 Express 应用：
import express from '@ikenxuan/amagi/express'
import { registerBilibiliRoutes, registerDouyinRoutes } from '@ikenxuan/amagi'
const app = express()
// 注册路由
app.use('/api/bilibili', registerBilibiliRoutes('your_cookie', {}))
app.use('/api/douyin', registerDouyinRoutes('your_cookie', {}))
app.listen(3000)最后更新于 2026-09-24