抖音直播间数据实时监控与分析工具

这个工具解决什么问题

抖音直播间的数据散落在弹幕、在线人数、礼物消息等不同通道里，手动观察很难还原一场直播的互动节奏：弹幕峰值出现在哪个时刻、在线人数何时拉升、哪位观众送出了大额礼物。等到直播结束，这些信息基本无法回溯。这个技能面向需要在直播进行中同步采集数据、事后做分析的工程师：把弹幕、在线人数变化、礼物排行和互动统计自动化抓取下来，按时间戳归档成结构化文件。

核心能力与工作流程

• 弹幕采集：支持实时写入与批量写入两种模式，对应不同的稳定性与完整性取舍，结果输出为 output/danmu_*.json
• 在线人数记录：持续记录房间在线人数变化，生成 output/viewers_*.csv，可通过 --duration 指定监控时长（秒）
• 礼物与互动统计：统计礼物赠送排行与互动数据，输出 output/gifts_*.md，另有综合监控报告 output/report_*.json
• 统一入口：python3 scripts/main.py [子命令] [参数]，输出目录 output/ 自动生成并按时间戳归档
• 防风控：所有请求内置 2–5 秒随机延迟，该限速不可关闭

前置条件包括有效的抖音 Cookie、目标房间的 room_id（可从直播间链接提取）以及 Python 3.8+ 环境，配置细节见 references/ 下的 Cookie 设置与使用文档。配合 OBS 等录屏工具，还可以用采集到的时间点为直播回放做标记。

适用边界

本工具仅供学习和研究：禁止绕过抖音官方 API 做逆向工程，禁止将采集数据用于商业用途或二次分发，禁止高频请求触发平台风控，也禁止在未经授权时采集非公开直播间数据。使用时需遵守抖音平台用户协议与隐私保护原则。