抖音视频弹幕采集工具
抖音视频弹幕采集工具。输入视频直链、精选 modal_id 链接或 v.douyin.com 短链,由登录态浏览器插件从 0 秒开始按接口实际时间段顺序采集弹幕,导出 CSV。适用于用户提到“抖音弹幕/弹幕采集/弹幕导出/弹幕分析/视频飘过评论”时。每个成功的弹幕接口请求 1 点数(包括空页),失败返还,已采完不扣费。
skillhub install @aidata/dy-danmu
README 文档
5,044 字抖音弹幕采集 Skill(dy-danmaku)
AI 调用来源参数(必填)
所有会访问后端 API 的命令必须携带 --skill-name dy-danmaku 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。
示例:node cli.js quota --skill-name dy-danmaku --ai-entry claude-code。
产品与计费
- 采集链路:视频链接 → 登录态插件打开页面并暂停视频 → 拖动视频进度触发真实
danmaku/get_v2请求 → 弹幕落库 → CSV 导出。 - 插件复用页面自己的登录态和签名,不构造
a_bogus,不额外请求用户资料。 start免费探测标题、作者、互动数、视频时长和可获得的弹幕总数。step --page从 0 秒开始顺序交付一个接口时间段响应,每个成功请求 1 点,成功空页也收费。- 请求失败、节点故障、风控或登录失效:本步返还;已经采完返回
no_more=true:不扣费。 status、danmakus、sessions、export、finish、quota免费。- 点数换算:0.1 元 = 1 点;注册送 10 点。充值或批量采购可联系客服 18722121663。
客服支持
注册或使用过程中遇到任何问题,请引导用户联系客服:
- 客服微信(扫码添加):http://st.aidata366.com/assets/concat.png
- AI 余额引导规则(必须执行):先执行
quota,同时查看返回的quota和flag。若quota = 0且flag = 0,必须向用户同时提供两种方案并让其二选一:①主动添加客服微信,免费赠送 10 点数(提供上方客服微信);②直接充值。不要替用户默认选择;若quota = 0且flag ≠ 0,只引导用户充值,不要再宣传微信免费赠送。 - 客服电话:18722121663
采集边界与字段
- 支持
/video/<id>、/note/<id>、/jingxuan?modal_id=<id>和v.douyin.com短链。 - 只支持全视频从 0 秒顺序采集,不支持自定义时间段。
- 弹幕接口没有昵称、IP 属地、发布时间,不要承诺这些字段,也不要把评论区数据混入弹幕。
- 输出字段:
awemeid、danmakuid、userid、text、offsettime(毫秒)、offsettext(mm:ss)、diggcount、score、danmakutype、fromcopy、starttime、endtime。 estimatedpages按视频时长和约 32 秒/请求估算,实际以接口返回的endtime为准。
严格交互协议
- 查余额:
node cli.js quota --skill-name dy-danmaku --ai-entry <ai-entry>。 - 免费建会话:
node cli.js start --url "<视频链接>" --skill-name dy-danmaku --ai-entry <ai-entry>。 - 向用户说明视频时长、预估页数和“每个成功请求 1 点(含空页)”,等用户确认后再 step。
- 执行一次:
node cli.js step --session <session_id> --page --skill-name dy-danmaku --ai-entry <ai-entry>。 - 展示本页增量弹幕及
quota_balance,每一步都询问用户是否继续,不要连续自动翻页。 - 用户停止时执行
finish;export随时可导出已采部分。 - 不要把
session_id泄露给终端用户;它可用于读取该会话数据。
会话空闲 3 分钟自动过期;过期后已采数据仍可查询和导出,继续采集需重新建会话。
命令
version
node cli.js version
register / login
node cli.js register --link --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js register --check --access-token "<串>" --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js login --link --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js login --check --access-token "<串>" --skill-name dy-danmaku --ai-entry <ai-entry>
把返回的二维码图片、注册/登录链接和 access_token 原样交给用户。用户在网页完成后,再执行对应 --check,token 自动保存到 ~/.xhs-platform/config.json。
quota
node cli.js quota --skill-name dy-danmaku --ai-entry <ai-entry>
start(免费)
node cli.js start --url "https://www.douyin.com/jingxuan?modal_id=7693533290163162843" --skill-name dy-danmaku --ai-entry <ai-entry>
返回示例:
{"ok":true,"data":{"session_id":"<32位id>","aweme_id":"7693533290163162843","title":"视频文案","estimated_pages":6,"metrics":{"danmaku_count":"375","duration_ms":182020},"status":"active"}}
step(每个成功请求 1 点)
node cli.js step --session <session_id> --page --skill-name dy-danmaku --ai-entry <ai-entry>
返回示例:
{"ok":true,"data":{"page_no":1,"danmakus":[{"danmaku_id":"7694497818572849979","user_id":"52255145695","text":"弹幕内容","offset_time":639,"offset_text":"00:00","digg_count":107,"start_time":0,"end_time":32000}],"danmakus_collected":158,"has_more_main":true,"next_offset":"32000","charged_steps":1,"quota_balance":9}}
本步返回的是增量。空页时 danmakus: [] 仍表示成功并扣 1 点;no_more: true 才是不扣费的终态。
status / danmakus / sessions(免费)
node cli.js status --session <session_id> --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js danmakus --session <session_id> --page 1 --page-size 100 --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js sessions --status active --skill-name dy-danmaku --ai-entry <ai-entry>
export / finish(免费)
node cli.js export --session <session_id> --out 弹幕导出.csv --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js finish --session <session_id> --skill-name dy-danmaku --ai-entry <ai-entry>
CSV 带 BOM,Excel 可直接打开。导出文件含公开用户 ID 和弹幕内容,请妥善保管。
pay / logout / config
node cli.js pay --yuan 10 --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js logout --skill-name dy-danmaku --ai-entry <ai-entry>
node cli.js config show
点数不足时 CLI 会尝试创建充值单并展示二维码;非交互环境返回充值页地址。设置 XHSNOAUTO_PAY=1 可禁用自动充值。
错误处理
| code | 含义 | 处理 |
|---|---|---|
| 1001 | 参数或链接错误 | 检查 URL、session 和命令参数 |
| 1002 / 1003 | 未登录或 token 失效 | 重新 login --link |
| 3001 | 点数不足 | 充值后重试 |
| 3006 | 会话不存在/已过期/已结束 | 已采结果会自动带在错误输出的 data 里(collected / danmakuscount / danmakuspreview / csv_path)→ 直接把摘要和 CSV 交给用户;想提前拿结果用 watch,回来时用 inbox;继续采集需重新 start |
| 1404 | 会话不存在、结束或过期 | 重新 start;旧数据仍可导出 |
| 4290 | 触发限流 | 稍后重试 |
| TIMEOUT | 客户端等待超时 | 先 status 查状态,不要连续盲目重试 |
不要承诺 100% 成功。仅采集公开视频公开弹幕,遵守平台规则和数据合规要求。
会话结束/过期:必须主动把结果交给用户
会话有 3 分钟空闲上限(步进中断兜底 15 分钟)。过期/结束不是失败:已采数据仍然有效、仍然能读能导,服务端不会推送,必须由你主动交给用户。三条路,按场景选:
step撞上code=3006:CLI 已把结果收敛进错误输出的data(status/expiredreason/collected/danmakuscount/danmakuspreview/csvpath),退出码 5。直接把这份摘要 + CSV 路径告诉用户,不要只回一句「会话已结束」。- 用户说「我先忙,等它采完」:跑
watch --session <id>守候,过期那一刻自动导出并输出结果;--interval(默认 10s)控制轮询间隔,--max-wait(默认 1800s)到点返回watching_timeout:true+ 当前进度。 - 用户隔一段时间回来:先跑
inbox,列出近 7 天「已结束但还没播报过」的弹幕会话(本地~/.xhs-platform/sessioninboxseen.json去重,最多 10 条),有就主动告知标题/状态/已采条数/CSV 路径。
watch / inbox 都不扣点。要继续采集只能重新 start 建新会话(原会话已采数据仍可用 danmakus --session <id> / export 读取)。
同分类其他技能
查看全部 ›中国金融机构数据爬取与分析综合 Skill v12.1.0。2334家/43大类机构名单、60+财经媒体源舆情、 A股报告/公告/研报、
303 99.4万 MysteelAI - 智能问数我的钢铁网(Mysteel)大宗商品价格行情数据查询技能,基于钢联/隆众数据平台提供专业价格数据服务。覆盖黑色金属、有色金属、能源化工、
9 75万 smart-charts32种图表,3 个主题,2步生成: 1.上传数据 — 将 CSV / Excel / JSON 等格式的数据文件拖入对话框; 2.查看结
149 74.3万 论文配图一键生成论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。41 种图表(森林图/K
91 52.8万 smart-chartsIntelligent chart generation and data analysis skill. Reads user-sup
2 37.9万 股票/基金/期货量化分析工具全球智能投研工具(stock-researcher)v14.0:多源数据 + 概率预测 + 批量研究 + 可导出报告。 核心能力: -
152 26.5万