视频号高播放直播预告筛选

要解决的问题

拿到一批视频号直播预告作品链接后，人工逐个点开核对播放量既不现实，也难以保证口径一致。更麻烦的是，本地缓存的播放数字和平台页面未必对齐，筛选结果往往事后无法复核。这个技能要解决的就是这件事：给一批公开作品链接，按播放数据挑出高播放的那部分，并把每条候选的原始快照留下来。

核心能力与工作流

输入是多个 https://channels.weixin.qq.com/platform/post/ 形式的公开作品链接，外加可选的数量或播放门槛。技能按以下步骤执行：

• 校验链接有效性：确认每个 URL 指向具体作品，拒绝账号主页、搜索页、含凭据的 URL 和本地网络地址。
• 串行采集：每个候选链接只请求一次，串行获取数据，避免并发触发限流。
• 严格筛选：排除缺少播放数的候选，不做任何补值；按用户指定门槛或在候选集合内按播放数排序，并明确说明这只是小集合内的对比，不是全平台榜单。
• 留档可复核：每次采集生成一个 engagement.json，记录源 URL、原始字段、缺失项和警告，同时标注采集时间与平台指标口径。

密钥与失败处理

脚本通过 --api-key 参数或 UNITYCLAW_KEY 环境变量读取密钥，两种方式都没有时引导用户前往 unityclaw.com 获取。任何情况下都不会回显、记录或把真实密钥写入结果文件。仅当参数修复和允许的瞬时重试都已结束、任务仍然最终失败时，才会展示 references 目录中内嵌的加群二维码，并附带失败原因说明。

适用边界

• 能用：用户给出多个公开视频号直播预告作品链接，要求按播放数据筛选。
• 不能用：账号主页资料分析、私有作品读取、内容脚本拆解，或从互动计数推断受众身份、真实转化和投资回报。
• 注意：快照带有明确采集时间，不同时间取的数据不能当作同一时点比较。