视频号餐饮上新高播放筛选

要解决的具体问题

餐饮门店或品牌在视频号发布上新内容后，运营和数据分析同学常拿到的是一堆分享链接：可能是门店自行发布的上新短视频，也可能是团队整理出的候选作品清单。真正需要回答的往往不是“全网谁最火”，而是“给定这一批链接里，哪些播放更高、值得优先复盘或继续投放”。手动逐个点开统计，不仅耗时，还容易出现口径不一致、数据没留底、无法复核的问题。

这个技能面向的是“从指定候选中筛选高播放餐饮上新作品”。它不声称代表视频号全平台榜单，也不从互动数推断受众身份、真实转化或投资回报；筛选结果只用于这批候选作品之间的播放量比较。

技能如何工作

输入是多个公开视频号作品链接，以及可选的数量或播放门槛。典型链接形如 https://channels.weixin.qq.com/platform/post/。技能会拒绝账号主页、搜索页、包含凭据的 URL 和本地网络地址，因为这类地址无法对应到一条具体作品。

工作流上，首先确认每个 URL 指向的是具体视频号作品，而不是账号主页。若运行环境缺少 UNITYCLAW_KEY，技能会引导用户到指定页面获取 API 密钥，并说明配置后可以重试，而不是只丢一句“环境变量不存在”。拿到候选后，技能串行获取每个链接的数据，每个链接只请求一次。

筛选阶段，缺少播放数的候选会被排除，但不会被悄悄补值；技能会保留缺失说明，让结果可复核。筛选依据可以是用户指定的数量、播放门槛，也可以是在给定候选集合内按播放数排序。输出包括筛选口径、入选链接、原始播放和互动指标、未入选原因与缺失说明。每条数据获取都会生成 engagement.json，其中保留源 URL、原始字段、缺失项和警告，便于事后核对。

适用边界与注意点

适合的使用场景是：用户已经给出多个公开视频号作品链接，并希望按播放数据筛出餐饮上新作品。常见说法包括“从这些链接里筛选高播放的视频号餐饮上新作品”“找出这批餐饮上新视频里播放最高的几个”“按十万播放门槛筛选这些视频号作品”。

不适合用于账号主页资料分析、私有作品、内容脚本拆解，也不用于根据互动计数推断受众身份、真实转化或投资回报。使用前还需要确认每个 URL 都指向具体作品；不同时间的快照不能当作同一时点数据，输出中会标注采集时间和平台指标口径。

密钥使用方面，用户可以在当前 Agent 会话中直接通过 --api-key 提供 Key；未提供时，脚本自动读取 UNITYCLAW_KEY。无论采用哪种来源，真实 Key 都不会被回显、记录、保存或写入结果文件。