技能介绍

要解决的问题

视频号创作者分析作品表现时，原生后台往往只提供基础视图，手动复制粘贴不仅繁琐，还容易在统计周期切换时出错。跨维度的数据（如各来源播放量、完播率、互动量）难以聚合成统一的时间序列，单篇作品封面和详细指标也无法快速批量导出。对于需要定期复盘、审计或接入自动化报表的工程师来说，需要一套能稳定绕过 UI 限制、直接抓取并结构化落盘的数据管道。

核心工作流

该技能通过 Playwright 驱动 Chromium 打开视频号助手。若本机微信在线，可自动完成免扫码登录，并将登录态持久化到 .chrome_profile/ 以实现后续秒登。脚本监听页面真实请求以动态捕获 _log_finder_id 等鉴权头，随后直接调用底层数据接口。

用户可通过命令行参数或管道输入指定统计周期（上一周、上一个月或自定义范围）。脚本会拉取经营数据并生成两份核心产物：

周期宽表 CSV：包含统计周期、各来源播放量（全部、推荐、分享、主页等）、朋友量、点赞、评论、分享及关注者总数。
单篇明细 CSV：包含标题、封面、发布日期、时长、播放量、完播率、平均播放时长及各项互动指标。
封面图片：按发布日期命名并下载至 dist/{时间}单篇封面/。

适用边界与注意点

该方案依赖本地 Chromium 环境，且仅适用于视频号助手 Web 端的数据口径。在对接接口时需特别注意字段映射的业务混淆点：朋友量对应的是 like/likeCount，而点赞量对应 fav/favCount，切勿按直觉硬编码。

时间戳计算需使用 Math.floor 避免精度丢失，且 endTs 为闭区间（取整月需包含最后一天）。单篇列表接口必须使用 micro/statistic 前缀 URL 及特定请求头，否则会触发 300999 错误。由于鉴权信息是动态获取的，更换账号后需重新运行以刷新 Token，不可硬编码。