视频号口碑作品数据对比

解决什么问题

视频号团队常常需要横向比较一批用户口碑作品的真实表现：同样是口播推荐，A 视频和 B 视频的播放量差多少？哪条的互动率更高？手工逐个点开链接、复制数字到表格里，不仅慢，还容易出错——快照时间不一致、部分指标缺失、口径说不清，最后得出的结论很难复核。这个技能把这件事变成一条可重复执行的流水线：只要给出至少两个公开作品链接，它就能拉取原始指标、生成同口径对比表，并为每次采集留下可回溯的数据文件。

工作方式

技能的核心流程可以拆成几步：

• 链接校验：先确认每个 URL 都指向具体的视频号作品（形如 https://channels.weixin.qq.com/platform/post/），拒绝账号主页、搜索页、含凭据的地址和本地内网地址。
• 串行采集：对每个链接只请求一次，串行执行，避免并发触发平台限制；每条结果都保留来源链接。
• 同口径建表：按播放、点赞、评论、收藏、分享等各作品共同存在的字段建立对比表，而不是把所有字段硬塞进一张表。
• 缺失值处理：缺失字段保持为空，不用零填充；需要展示派生比率（如互动率）时，明确写出公式和分母，防止读数被误读。
• 留痕可复核：每次获取生成一个 engagement.json，记录源 URL、原始字段、缺失项和警告，供事后核验。

数据获取依赖 fieldkit-sdk@1.0.1 和 API 密钥，支持会话内直接传入或读取环境变量，密钥不会出现在回复、日志或结果文件里。

适用边界

这个技能只做「已发布作品的公开指标对比」这一件事，有明确的适用边界：

• 输入必须是公开作品链接，账号主页资料、私有作品不在范围内。
• 它不做内容脚本拆解，也不从互动计数推断受众身份、真实转化或投资回报——互动数据只是描述公开表现，不能替代归因分析。
• 快照时间不同的数据不能当作同一时点的对比结果，采集时间、来源链接和平台指标口径会一并标注，使用者需要自行留意时间差带来的偏差。
• 若任务在参数修复和允许的重试后仍然失败，技能会如实报告原因和排查进展，而不是包装成成功。