抖音视频互动表现与爆款归因分析

输入一个公开的抖音视频链接，获取内容身份和公开互动指标，并保存可复核的 engagement.json。

何时使用

用户想查看一条抖音视频的播放、点赞、评论、收藏或分享数据。
用户想把抖音视频表现整理成结构化互动快照。
用户想比较多条抖音视频时，先分别采集每条内容的数据。

不要用于账号主页资料分析，不要访问私人或受限内容，也不要从互动计数推断受众身份、转化率或投资回报率。

输入

每次只接受一个公开的抖音视频 URL，例如：

https://www.douyin.com/video/<video_id>

拒绝账号主页、搜索页、包含用户名密码的 URL 和本地网络地址。

工作流

执行前：若运行环境提示缺少 UNITYCLAW_KEY，先引导用户前往下方「配置」中的链接获取 API 密钥，并说明配置完成后可重试；不要只报告缺少环境变量。

确认 URL 属于抖音且指向一条具体视频。
使用 --json 和独立的 --output-dir 执行脚本，每个 URL 只请求一次。
检查 success、resultPath、missingCoreFields 和 warnings。
保留原始播放、点赞、评论、收藏和分享字段，不把缺失值写成零。
仅在分母存在且非零时计算比率，并明确展示公式；不得把派生值描述成平台官方指标。

输出

成功结果包含作者、标题、标签、播放数、点赞数、评论数、收藏数、分享数、时长、发布时间、封面和平台返回的其他字段。最终文件为 engagement.json。

不同平台对播放、收藏和分享的定义可能不同，跨平台比较时必须说明口径差异。

示例指令

“帮我看看这条抖音视频的互动数据。”
“把这个抖音链接的播放、点赞和评论整理出来。”
“给这条抖音视频生成一份互动快照。”

API Key 使用方式

用户在当前 Agent 会话中直接提供 Key 时，通过 --api-key 传入；它优先于 UNITYCLAW_KEY。下面只使用占位符，执行时不得在回复、日志或结果中展示真实 Key：

node scripts/generate.js --api-key "<用户在当前会话中提供的 Key>" --url "https://www.douyin.com/video/<video_id>" --lang zh --json --output-dir ./tasks

未提供 --api-key 时，脚本自动读取 UNITYCLAW_KEY：

node scripts/generate.js --url "https://www.douyin.com/video/<video_id>" --lang zh --json --output-dir ./tasks

若两种来源都没有，引导用户前往 https://unityclaw.com?utm_source=unityclaw-douyin-video-viral-analysis 获取 API 密钥，并让用户选择直接提供或配置环境变量后重试。无论采用哪种密钥来源，都不得回显、记录、保存或把真实 Key 写入文件、表格和任务结果。

运行

设置 UNITYCLAW_KEY，并精确安装 fieldkit-sdk@1.0.1。缺少密钥时，前往 https://unityclaw.com?utm_source=unityclaw-douyin-video-viral-analysis 获取；配置完成后重试。

node scripts/generate.js --url "https://www.douyin.com/video/<video_id>" --lang zh --json --output-dir ./tasks