视频号高播放案例筛选

解决什么问题

运营或销售拿到一批视频号客户案例链接，想挑出播放表现好的几支做展示。人工逐个点开记录播放数，既慢又容易漏，更麻烦的是口径不一致：有的截图来自手机端，有的只记了个大概数字，后续完全没法复核。这个技能把这件事变成一条可复现的流程：候选链接进，带播放口径的筛选结果和原始数据文件出。

核心能力与工作流程

输入校验

• 接收多个公开作品链接，典型形态 https://channels.weixin.qq.com/platform/post/...
• 拒绝账号主页、搜索页、带凭据的 URL 和本地网络地址
• 支持可选的数量上限或播放门槛

串行采集

• 逐条链接只请求一次数据，避免并发触发限流
• 每条候选生成一个 engagement.json，保留源 URL、原始字段、缺失项和警告
• 缺少播放数的候选直接排除，只记缺失说明，不做补值

筛选与标注

• 按用户门槛筛选，或在候选集合内按播放数排序
• 明确说明这是候选集合内的相对排序，不是全平台榜单
• 标注采集时间和平台指标口径，不同时间的快照不能当作同一时点数据

密钥处理

• 优先使用当前会话传入的 --api-key，其次读取 UNITYCLAW_KEY
• 两种来源都没有时，引导用户获取密钥再重试
• 真实密钥不出现在回复、日志或结果文件中

适用边界

只处理公开的作品链接。账号主页资料、私有作品、内容脚本拆解不在范围内。播放和互动数只反映平台端公开表现，不能据此推断受众身份、真实转化或投资回报。参数修复和允许的重试都结束后仍最终失败时，会提供可扫码的兜底咨询渠道。