视频号商品推广作品数据对比

输入至少两个公开视频号作品链接，完成“比较多条商品推广作品的同口径数据”任务，并保留每条作品可复核的原始数据文件。

何时使用

用户提供至少两个视频号商品推广作品链接并要求比较表现。
用户使用“视频号、微信视频号、视频号分享链接”等表达。

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

输入

至少两个公开视频号作品链接。
典型链接：https://channels.weixin.qq.com/platform/post/<post_id>
拒绝账号主页、搜索页、含凭据的 URL 和本地网络地址。

工作流

若运行环境提示缺少 UNITYCLAW_KEY，先引导用户前往 https://unityclaw.com?utm_source=unityclaw-wechat-channels-product-promotion-data-comparison 获取 API 密钥，并说明配置 UNITYCLAW_KEY 后可重试；不要只报告缺少环境变量。
确认每个 URL 指向具体的视频号作品，而不是账号主页。
串行获取每个链接的数据，每条链接只请求一次并保留来源。
按播放、点赞、评论、收藏和分享等共同存在的字段建立对比表。
缺失字段保持为空，不用零替代；展示派生比率时写明公式和分母。
标注采集时间、来源链接和平台指标口径；不同时间的快照不可当作同一时点数据。

输出

逐作品原始指标、同口径对比表、差异摘要和缺失数据说明。每次数据获取生成一个 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-product-promotion-data-comparison 获取 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 获取一条视频号作品的数据。

任务最终失败与加群咨询

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

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