TikTok TK 视频互动与热词分析

要解决什么问题

做 TikTok 内容复盘或横向对比时，你往往只有一条公开视频链接，却需要在浏览器里反复点开统计区，再手工抄到表格里。口径不统一、截图难复核，也容易把「字段缺失」误记成 0。这个技能把单条公开视频的互动指标收成一份结构化快照，便于存档和后续对比。

技能如何工作

每次只接受一个公开的 TikTok 视频 URL（拒绝主页、搜索页、带凭证的地址和本地网段）。典型流程是：

1. 确认链接指向 TikTok 上的具体视频，而不是账号或列表页。
2. 通过脚本以 --json 与独立 --output-dir 拉取数据，每个 URL 只请求一次。
3. 检查 success、resultPath、missingCoreFields 与 warnings，再决定结果是否可用。
4. 保留平台返回的播放、点赞、评论、收藏、分享等原始字段；缺失值不写零。若需比率，仅在分母存在且非零时计算，并写明公式——不把派生值说成平台官方指标。

成功时你会得到作者、标题、标签、各互动计数、时长、发布时间、封面等平台字段，落盘为 engagement.json，方便 diff 与留痕。

适用边界与注意点

• 不要用于账号主页画像、私密或受限内容；也不要从互动数字推断受众身份、转化率或 ROI。
• 播放、收藏、分享等指标在不同产品上的定义可能不一致；跨平台对比时要先说明口径。
• 若环境缺少 UNITYCLAW_KEY，应先按技能说明完成密钥配置再重试；密钥不得出现在回复、日志或输出文件里。