视频号服装穿搭作品数据分析

解决什么问题

视频号服装穿搭类创作者常需要回答两个问题：一条作品实际触达了多少人，互动结构是否健康。然而平台页面只展示当前数值，缺少时间维度、原始字段和可复核快照；手工截图或录屏既难量化，也无法做跨作品比较。这个技能针对单条公开作品做一次结构化抓取，把播放、点赞、评论、收藏、分享等指标落到本地 JSON，供后续人工查看或脚本复用。

核心能力与关键步骤

• 输入校验：接收一个视频号公开作品链接，典型形式为 https://channels.weixin.qq.com/platform/post/...。技能会拒绝账号主页、搜索页、含凭据的 URL 和本地回环地址，确保每次任务都指向具体作品。
• 原始字段保留：通过 scripts/generate.js 调用 fieldkit-sdk@1.0.1 获取一次数据，平台返回的字段原样写入 engagement.json，不做裁剪或重排。
• 派生比率计算：只有当 播放数 存在且非零时，才基于原始字段计算点赞率、评论率、收藏率、分享率等指标，并在输出中写明公式，例如 互动率 = (点赞 + 评论 + 收藏 + 分享) / 播放数。
• 快照可复核：每次生成的 engagement.json 同时保留源 URL、采集时间、缺失项和警告，不同时刻抓到的数据不会被当成同一时点。
• 密钥处理：支持 --api-key 或 UNITYCLAW_KEY，两者都没有时会引导用户前往 unityclaw.com 获取，而不是只抛环境变量错误。真实密钥不会写入结果文件或日志。

适用边界与注意点

• 只处理公开作品，不覆盖账号主页资料、私有内容或需要登录才能访问的页面。
• 不做内容脚本拆解，也不从互动计数推断受众身份、真实转化或投资回报。
• 不同时间采集的快照会因平台计数修正而产生差异，不能直接当作同一时点数据做同比。
• 指标口径以平台返回为准，技能会标注来源链接与采集时间，但不会自行修正平台已删除或失效的字段。