Instagram Reels 互动数据分析

问题：互动数据散落且不可复核

复盘某条 Reel 的表现时，常见做法是打开 App 肉眼扫一遍播放、点赞、评论、收藏、分享，再手抄进表格。这种快照没有出处，事后审计时说不清某个数字是怎么来的。这个技能把单条公开 Reel 的采集固化为一次可复核的流程：输入一个公开链接，输出结构化的 engagement.json，每个字段都有来源。

工作方式

1. URL 校验：只接受指向具体 Reel 的公开链接，拒绝账号主页、搜索页和带凭据的 URL；每个 URL 只请求一次。
2. 结构化采集：脚本以 --json 和独立的 --output-dir 运行，保留作者、标题、标签、时长、发布时间、封面等原始字段。
3. 完整性检查：执行后核对 success、resultPath、missingCoreFields 和 warnings，缺失指标不会写成 0，而是原样标记为缺失。
4. 派生计算：仅当分母存在且非零时计算互动比率，并明确展示公式；派生值不会被表述成平台官方指标。

密钥与边界

API 密钥通过 --api-key 传入，或由环境变量 UNITYCLAW_KEY 自动读取；任何情况下都不会在回复、日志或结果文件中回显真实 Key。

适合单条公开内容的采集，不适合账号主页整体分析，也不能用于推断受众身份、转化率或投资回报率。跨平台比较播放、收藏、分享时，需自行注明口径差异。