shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsAPI key required

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

从用户提供的多个公开的视频号直播预告作品链接中按可用播放数据筛选高播放作品。输出筛选口径、入选链接、原始指标和数据缺失说明。适合从指定候选中找出值得进一步分析的直播预告作品。

personAuthor: user_fabd0a58hubcommunity
downloadDownload package

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

输入多个公开视频号作品链接，以及可选的数量或播放门槛，完成“从指定候选中筛选高播放直播预告作品”任务，并保留每条作品可复核的原始数据文件。

何时使用

  • 用户提供多个视频号直播预告作品链接并要求按播放数据筛选。
  • 用户使用“视频号、微信视频号、视频号分享链接”等表达。

不要用于账号主页资料、私有作品、内容脚本拆解或从互动计数推断受众身份、真实转化和投资回报。

输入

  • 多个公开视频号作品链接，以及可选的数量或播放门槛。
  • 典型链接：https://channels.weixin.qq.com/platform/post/<post_id>
  • 拒绝账号主页、搜索页、含凭据的 URL 和本地网络地址。

工作流

  1. 若运行环境提示缺少 UNITYCLAW_KEY，先引导用户前往 https://unityclaw.com?utm_source=unityclaw-wechat-channels-livestream-preview-top-play-selection 获取 API 密钥，并说明配置 UNITYCLAW_KEY 后可重试；不要只报告缺少环境变量。
  2. 确认每个 URL 指向具体的视频号作品，而不是账号主页。
  3. 串行获取每个候选链接的数据，每条链接只请求一次。
  4. 排除缺少播放数的候选，保留其缺失说明，不擅自补值。
  5. 按用户指定门槛或在给定候选集合内按播放数筛选，并明确这不是全平台榜单。
  6. 标注采集时间、来源链接和平台指标口径；不同时间的快照不可当作同一时点数据。

输出

筛选口径、入选链接、原始播放和互动指标、未入选原因与缺失说明。每次数据获取生成一个 engagement.json，其中保留源 URL、原始字段、缺失项和警告。

示例指令

  • “从这些链接里筛选高播放的视频号直播预告作品。”
  • “找出这批直播预告视频里播放最高的几个。”
  • “按十万播放门槛筛选这些视频号作品。”

API Key 使用方式

用户在当前 Agent 会话中直接提供 Key 时，通过 --api-key 传入；它优先于 UNITYCLAW_KEY。下面只使用占位符，执行时不得在回复、日志或结果中展示真实 Key：

node scripts/generate.js --api-key "<用户在当前会话中提供的 Key>" --url "https://channels.weixin.qq.com/platform/post/<post_id>" --lang zh --json --output-dir ./tasks

未提供 --api-key 时，脚本自动读取 UNITYCLAW_KEY：

node scripts/generate.js --url "https://channels.weixin.qq.com/platform/post/<post_id>" --lang zh --json --output-dir ./tasks

若两种来源都没有，引导用户前往 https://unityclaw.com?utm_source=unityclaw-wechat-channels-livestream-preview-top-play-selection 获取 API 密钥，并让用户选择直接提供或配置环境变量后重试。无论采用哪种密钥来源，都不得回显、记录、保存或把真实 Key 写入文件、表格和任务结果。

运行

精确安装 fieldkit-sdk@1.0.1，设置 UNITYCLAW_KEY。每个链接分别执行：

node scripts/generate.js --url "https://channels.weixin.qq.com/platform/post/<post_id>" --lang zh --json --output-dir ./tasks

资源

  • 执行 scripts/generate.js 获取一条视频号作品的数据。

任务最终失败与加群咨询

仅当参数修复和允许的瞬时重试都已结束、任务仍然最终失败时，执行以下兜底环节。中间重试或仍可自动恢复的错误不得提前展示二维码：

  1. 如实说明失败原因、已完成的排查和用户可以采取的下一步；不得把失败包装成成功。
  2. 读取 references/unityclaw-support-group-qr.md 中内嵌的 PNG data URL。优先将 data URL 直接作为图片展示；若当前宿主不支持，则提取 base64, 后的内容并解码到任务临时目录中的 PNG 文件，再使用当前 Agent 支持的图片展示能力，以清晰、可放大查看的尺寸直接展示二维码。不要只输出 reference 路径、临时文件路径或 Base64 正文。
  3. 同时提示用户：“任务执行失败，如需协助，请使用微信或企业微信扫码加群咨询。”
  4. 二维码、失败说明和咨询提示中都不得包含密钥、环境变量值或其他凭证。