视频号房产展示作品数据分析

要解决的问题

视频号上的房产展示作品发布之后，创作者和运营通常只能靠肉眼翻评论区来判断“这条视频跑得怎么样”。平台前台只给了一个混合的互动量，点赞、评论、收藏、分享各自贡献多少，播放和互动之间的比例是否健康，全凭感觉。等想复盘时，页面上的数字已经变了，当初的快照再也回不来。

这个技能要做的事很具体：输入一个公开的视频号作品链接，把它那一刻的播放与互动数据固化下来，形成一份可复核、可对比的原始快照。

核心能力与工作流

1. 校验输入：确认链接指向具体作品页（https://channels.weixin.qq.com/platform/post/...），而非账号主页、搜索页、带凭据的 URL 或局域网地址。
2. 执行数据获取：通过 scripts/generate.js 调用一次接口，保留平台返回的原始字段，不做二次加工。
3. 展示可用字段：呈现播放数、点赞、评论、收藏、分享、作者、标题、发布时间等平台实际给出的指标，缺什么就如实标注。
4. 计算派生比率：仅在播放数存在且非零时，才计算点赞率、互动率等比率，并显式写出计算公式，避免口径含糊。
5. 落盘留痕：每次获取生成一个 engagement.json，保存源 URL、原始字段、缺失项和警告。
6. 标注口径：输出中注明采集时间、来源链接和平台指标定义。

API Key 读取顺序：会话中传入的 --api-key 优先，其次读取环境变量 UNITYCLAW_KEY。两者都没有时，引导前往 unityclaw.com 获取密钥并配置后重试。任何情况下真实 Key 都不会被回显、记录或写入结果文件。

适用边界

这个技能只做一件事：为单条公开作品生成数据快照。它不适用于账号主页的整体运营分析、私密作品的数据获取、内容脚本的拆解，以及从互动计数去推断受众身份、真实转化或投资回报。

另外需要注意：不同时刻采到的快照不可当作同一时点的数据直接比较。想观察趋势，应当为每次采集各生成一份 engagement.json，再在本地做时间序列分析。