视频号知识科普作品数据分析

为什么需要单作品数据快照

知识科普视频的运营复盘，往往卡在数据口径不统一。作者能从后台看到播放、点赞、评论、收藏、分享等指标，但这些快照通常难以回溯到同一条作品在具体时间点的状态。更麻烦的是，如果只凭后台截图或记忆比较不同视频的互动差异，很容易把发布时间、推荐流量、选题难度等变量混在一起，最后得到的不是可执行的结论，而是难以复现的印象。

这个技能解决什么问题

视频号知识科普作品数据分析 针对一条公开视频号作品链接，完成一次可复核的数据快照任务。它不做账号级汇总，也不尝试从互动计数推断受众身份、真实转化或投资回报，而是把分析范围限定在单个作品的播放与互动表现上。

核心能力

• 单作品原始快照：只接受指向具体作品的公开链接，对每个 URL 执行一次数据获取，并保留平台返回的原始字段。
• 有条件派生比率：只有播放数存在且非零时，才计算点赞率、评论率、收藏率、分享率等派生互动比率，并明确写出公式，避免把不可比数据当成结论。
• 可复核留痕：每次数据获取都会生成 engagement.json，其中保留源 URL、原始字段、缺失项和警告，便于事后核对指标口径和采集时间。

关键步骤

1. 若运行环境缺少 UNITYCLAW_KEY，先引导用户前往 UnityClaw 获取 API 密钥；用户也可直接提供 Key，并通过 --api-key 传入，优先级高于环境变量。
2. 校验每个 URL 是否指向具体作品，拒绝账号主页、搜索页、含凭据的 URL 和本地网络地址。
3. 执行一次数据获取，保留平台返回的播放、点赞、评论、收藏、分享、作者、标题和时间等可用字段。
4. 对符合条件的作品计算派生互动比率，并在结果中写出公式。
5. 标注采集时间、来源链接和平台指标口径；不同时间的快照不可当作同一时点数据。

适用边界

• 只用于公开视频号作品，不用于账号主页资料、私有作品、内容脚本拆解，也不从互动数据推断受众身份、真实转化和投资回报。
• 需要配置 UNITYCLAW_KEY 或通过 --api-key 传入密钥；真实 Key 不应回显、记录、保存或写入结果文件。
• 不同时间采集的快照只代表各自采集时点的数据状态，不能直接拼成连续时间序列。