视频号案例作品数据快照

要解决的问题

视频号的案例展示作品常被当作对外材料传播，但当团队需要复盘某条作品的播放量、点赞、评论、收藏与分享构成时，往往缺少一种可复核的方式：截图只保留了画面，临时抓数脚本的结果没有留存，不同成员的统计口径也不一致。这个技能只做一件事——把一条公开视频号作品的数据拉成一份带原始字段的快照，让「这条视频表现如何」有据可查。

核心能力与关键步骤

• 输入校验：接收一个公开作品链接（形如 https://channels.weixin.qq.com/platform/post/...），先确认它指向具体作品而非账号主页或搜索页，拒绝含凭据的 URL 与本地网络地址。
• 一次获取、保留原始字段：对链接执行一次数据获取，把平台返回的字段原样写进 engagement.json，并附带源 URL、缺失项与警告。
• 展示可用指标：呈现播放、点赞、评论、收藏、分享、作者、标题和时间等平台返回的字段。
• 派生比率附带公式：只有播放数存在且非零时才计算互动比率，并明确写出计算口径，例如 (点赞 + 评论 + 收藏 + 分享) / 播放。
• 标注快照口径：记录采集时间、来源链接与平台指标口径；不同时间的快照不可当作同一时点的数据。

适用边界

它不是账号分析工具：不用于账号主页资料汇总，不处理私有作品，不做内容脚本拆解，也不能从互动计数推断受众身份、真实转化或投资回报。运行前需配置好 UNITYCLAW_KEY（或通过 --api-key 传入），真实 Key 不会出现在回复、日志或结果文件中；仅当参数修复与重试都失败后，才会展示兜底的加群咨询二维码。