视频号直播预告作品数据对比

它解决什么问题

视频号直播预告通常会同时发布多条作品，运营和数据同学需要判断哪条预告真正带来了更高的曝光和互动。手工复制链接、逐个查看后台、再把数字抄进表格，既容易抄错，也难以保证对比口径一致。这个技能直接接收 https://channels.weixin.qq.com/platform/post/ 形式的公开作品链接，把多条预告作品拉到同一张对比表里，并保留每条作品的原始数据文件，方便事后复核。

核心能力

• 多作品同口径对比：支持输入至少两个公开作品链接，串行获取数据，按播放、点赞、评论、收藏、分享等共同存在的字段生成对比表。
• 可复核的原始数据：每条作品获取完成后生成一个 engagement.json，其中保留源 URL、原始字段、缺失项和警告。
• 派生比率透明：展示比率时写明公式与分母，缺失字段保持为空，不用零填充。
• 口径标注：明确记录采集时间与平台指标口径，不同时间的快照不会被当作同一时点数据。

执行流程

1. 运行前检查 UNITYCLAW_KEY 是否存在；若缺失，引导用户前往指定页面获取 API 密钥，说明配置后可重试。
2. 逐条确认 URL 指向具体作品，而不是账号主页或搜索页。
3. 每条链接只请求一次，串行获取并保留来源。
4. 汇总为同口径对比表，输出差异摘要与缺失数据说明。

适用边界

只处理公开视频号作品链接。不接受账号主页、搜索页、含凭据的 URL 或本地网络地址。不用于私有作品分析、内容脚本拆解，也不从互动计数推断受众身份、真实转化或投资回报。若密钥通过 --api-key 直接传入，任务全程不会在回复、日志或结果文件中回显密钥。