抖音视频互动与爆款归因

问题：把一条抖音视频的公开互动指标落成可复核数据

一条抖音视频的播放、点赞、评论、收藏和分享数散落在页面里，手工抄写既容易漏项，也难复现口径。做内容复盘或多条视频对比时，更需要一份字段清晰、缺失值明确的结构化快照。该技能针对单个公开抖音视频 URL，采集内容身份和公开互动指标，并生成 engagement.json，方便后续保存、比较或审计。

工作方式：单链接采集、结构化落盘与结果检查

• 只接受一个公开抖音视频 URL，先确认链接属于抖音且指向具体视频；账号主页、搜索页、含用户名密码的 URL 和本地网络地址会被拒绝。
• 脚本以 --json 和独立 --output-dir 运行，每个 URL 只请求一次，避免重复请求。
• 执行后检查 success、resultPath、missingCoreFields 和 warnings，据此判断结果是否可用。
• 输出保留作者、标题、标签、播放数、点赞数、评论数、收藏数、分享数、时长、发布时间、封面及平台返回的其他字段。
• 播放、点赞、评论、收藏、分享等字段保留原始值；缺失值不会写成 0。若计算比率，只在分母存在且非零时进行，并明确展示公式；派生值不会被称作平台官方指标。

适用边界与注意点

• 适用于单条公开抖音视频的互动数据整理，不用于账号主页资料分析。
• 不访问私人或受限内容，也不从互动计数推断受众身份、转化率或投资回报率。
• 平台对播放、收藏、分享等指标的定义可能不同，跨平台比较时需要说明口径差异。
• API Key 可由用户在会话中通过 --api-key 传入，或由脚本读取 UNITYCLAW_KEY；真实 Key 不会回显、记录、保存或写入结果文件。
• 若运行环境提示缺少 UNITYCLAW_KEY，会引导获取密钥并在配置完成后重试。
• 只有在参数修复和允许的瞬时重试都结束、任务仍最终失败时，才会说明失败原因、排查情况和下一步，并展示支持二维码；中间重试或可恢复错误不会提前展示。