视频号教程视频数据分析

要解决什么问题

做教程类视频号内容时，你往往只有作品分享链接，却需要在同一套口径下对比播放、点赞、评论、收藏和分享，而不是凭后台截图或零散数字口头对齐。更麻烦的是：平台字段会缺、会变，若不留原始返回，过几天很难复核「当时到底采到了什么」。

本技能面向单条公开教程演示作品：输入作品 URL，完成一次可留档的数据快照，并在条件允许时给出可验算的互动比率。

工作方式

1. 校验链接：只接受指向具体作品的公开链接（典型形态含 channels.weixin.qq.com/platform/post/），拒绝账号主页、搜索页、带凭据的 URL 和本地地址。
2. 拉取原始数据：通过 scripts/generate.js 与 UnityClaw 数据接口获取平台返回字段，保留原始 JSON，每次生成 engagement.json（含源 URL、原始字段、缺失项与警告）。
3. 展示与派生指标：输出作者、标题、时间，以及播放、点赞、评论、收藏、分享等可用计数；仅当播放数存在且非零时计算派生互动比率，并写明公式。
4. 口径标注：记录采集时间与来源链接；不同时间的快照不可当作同一时点数据。

若环境缺少 UNITYCLAW_KEY，会引导前往 UnityClaw 获取密钥并说明配置后重试，而不是只报环境变量缺失。

适用边界

• 适合：查看教程演示作品的互动构成、可计算比率、需要可复核原始文件的一次性分析。
• 不适合：账号主页资料、私有作品、内容脚本拆解；也不要从互动计数推断受众身份、真实转化或 ROI。
• 密钥：可通过会话内 --api-key（优先）或 UNITYCLAW_KEY 提供；不得在回复、日志或结果中回显真实 Key。