漫剧榜开发者文档
短剧/漫剧广告投放数据分析平台，提供三种接入方式：AI Skill、命令行工具和 REST API。
接入方式对比
根据你的使用场景选择最适合的方式：
Drama Insight Skill
在 Claude Code 中直接用自然语言查询数据，无需写代码，适合探索性分析
CLI 工具
终端命令行客户端，支持 JSON 输出和管道操作，适合脚本自动化和批量查询
REST API
直接调用 HTTP 接口，集成到自己的应用中。完整文档见 API 文档
🤖 Drama Insight Skill — 什么是 Skill
Skill 是 Claude Code 的能力扩展。安装后，在对话中输入 /drama-insight 即可激活，用自然语言直接查询漫剧榜 API，无需手写 HTTP 请求。
适用场景：数据探索、趋势分析、竞品对比、今日榜单速查。
需要已安装 Claude Code（
npm install -g @anthropic-ai/claude-code）并在项目目录中运行。🤖 Drama Insight Skill — 安装配置
执行以下命令一键安装（macOS / Linux）：
Bash
curl -fsSL https://superline.video/install-drama-insight.sh | sh
配置 API Key（可选，不配置则为游客权限，数据有限制）：
Bash
export MANJUBANG_API_KEY=mjb_your_key
API Key 可在个人中心生成。配置后下次对话自动生效。也可以写入 shell profile（~/.zshrc 或 ~/.bashrc）永久保存。
如果只在某个项目中使用，也可以把文件放到项目的
.claude/skills/drama-insight/ 目录下，这样只对该项目生效。🤖 Drama Insight Skill — 使用示例
激活 Skill 后，可以用自然语言提问：
甜宠题材最近有哪些爆款？
对比《XXX》和《YYY》最近 7 天的投放趋势
哪个题材最近投放量增长最快？
今天新上线了哪些剧？
ReelShort 上甜宠题材的爆款配方是什么？
💻 CLI 工具 — 安装
需要 Python 3.11+，使用 pip 或 uv 安装：
Bash
pip install manjubang-cli # 或使用 uv（推荐） uv tool install manjubang-cli
安装后验证：
Bash
manjubang --version
💻 CLI 工具 — 快速上手
Bash
manjubang config set-key mjb_your_key # 配置 API Key manjubang health # 检查连接 manjubang dramas list # 查看今日榜单 manjubang --json dramas list | jq .total # JSON 模式管道
所有命令支持 --json 全局选项，输出原始 JSON，方便与 jq 等工具配合：
Bash
manjubang --json trends explosions | jq '.[].drama_name'
也可通过环境变量配置：
MANJUBANG_API_KEY=mjb_xxx manjubang dramas list💻 CLI 工具 — config
管理本地配置文件（存储于 ~/.config/manjubang/config.toml）。
| 命令 | 说明 |
|---|---|
config show | 显示当前配置（API Key 已脱敏） |
config set-key <KEY> | 保存 API Key（需 mjb_ 前缀） |
config set-url <URL> | 设置服务器地址（默认 https://superline.video） |
config reset | 清除所有本地配置 |
💻 CLI 工具 — dramas
查询剧集列表、详情、投放趋势和导出数据。
| 命令 | 说明 | 常用参数 |
|---|---|---|
dramas list | 剧集列表（按排名/投放量排序） | --date --tags --sort --period --page --size |
dramas detail <id> | 剧集详情 | — |
dramas trend <id> | 单剧投放趋势折线 | --start --end |
dramas compare <ids> | 多剧对比（逗号分隔 ID） | --start --end |
dramas export | 导出当日榜单为 XLSX | -o output.xlsx |
示例
manjubang dramas list --tags 甜宠 --sort ad_count --size 20 manjubang dramas trend 123 --start 2026-03-01 --end 2026-03-30 manjubang dramas compare 123,456,789
💻 CLI 工具 — trends
发现投放异动：爆量新剧、衰退剧集。
| 命令 | 说明 | 常用参数 |
|---|---|---|
trends explosions | 今日爆量剧（投放量大幅增长） | --date |
trends new | 新上线剧集 | --date --days |
trends declining | 投放衰退剧集 | --date |
💻 CLI 工具 — platforms
各投放平台（抖音、快手等）的数据对比与分析。
| 命令 | 说明 | 常用参数 |
|---|---|---|
platforms list | 平台列表及投放量排名 | --date |
platforms compare <names> | 多平台对比（逗号分隔） | --date |
platforms dramas <name> | 指定平台在投剧集列表 | --date |
💻 CLI 工具 — reelshort
ReelShort 平台书目数据与 AI 分析（含多维度标签分析）。
| 命令 | 说明 | 常用参数 |
|---|---|---|
reelshort books | 书目列表 | --sort --tag --lang --keyword --paid/--free |
reelshort detail <id> | 书目详情 | — |
reelshort trend <id> | 书目趋势 | --start --end |
reelshort tags | 标签分组列表 | — |
reelshort analysis quadrant | 四象限分析（热度 × 增长） | --category-id --min-count |
reelshort analysis heatmap | 标签热力图 | --top-n --min-quarter |
reelshort analysis formula | 爆款配方分析 | --top-n |
reelshort analysis trend | 标签趋势对比 | --min-count |
reelshort analysis cross | 双维度交叉矩阵 | --row-category --col-category --top-n |
reelshort analysis insight | AI 洞察文字 | --section |
示例
manjubang reelshort books --sort rank --tag romance manjubang reelshort analysis formula --top-n 20 manjubang reelshort analysis insight --section overview
💻 CLI 工具 — recommend
基于剧集或标签的相关推荐（ReelShort 方向）。
| 命令 | 说明 | 常用参数 |
|---|---|---|
recommend | 获取 ReelShort 相关推荐 | --drama-id 或 --tags --limit |
示例
manjubang recommend --drama-id 123 manjubang recommend --tags 甜宠,霸总 --limit 10