视频号直播数据复盘

它解决的问题

视频号助手的直播大屏数据分散在多个接口里，live_dashboard_data、live_ec_data_summary、live_comparison_index 等字段还以嵌套 JSON 字符串返回。手工复盘一场直播，要先在后台翻日期、逐个接口拼字段、换算单位，再自己写结论，流程重复且容易算错。

核心能力

技能用 AppID 与 AppSecret 调视频号助手 API，拉取指定日期的电商直播场次，并同时产出两种格式的复盘报告：

• MD 报告：结构化 Markdown，适合沉淀到 IMA 知识库或导入飞书
• HTML 报告：内置 Chart.js 图表，适合浏览器预览与团队分享

两份报告模块顺序完全一致，共 8 个模块：核心数据概览、流量来源分析、电商成交数据、商品销售 TOP 20、选品复盘、排品复盘、投流分析、总结与洞察。其中排品分类基于相对价格分位、GMV 占比与点击率中位数自适应划分；价格带按商品实际价格的 P25/P50/P75 分档。

关键步骤

1. 读取凭证（WX_APPID / WX_APPSECRET）并刷新 access_token
2. 调账号信息接口校验 AppID，取 nickname 与 fans_count
3. 用 getlivelist 按 ds（YYYYMMDD 整数）从当天向前回溯，定位最近一场电商直播
4. 拉取大屏原始 JSON 落盘为 raw_live_data.json
5. 分别运行 scripts/generate_report.py 与 scripts/html_report.py
6. 用 scripts/upload_to_ima.py 把 MD 报告上传到指定知识库

注意点

• 单位换算：GMV 与客单价原始单位是「分」，报告转成「元」；转化率是小数，乘 100 显示百分比；观看时长由秒转分秒。
• 异常场：观看人数 ≤1 且上架商品数 =0 的场次会被标记 _abnormal: true，报告为空壳（GMV 为 0），需与用户确认是否保留。
• 同日可能多场，脚本按 create_time 取最新，不能直接读列表首条。
• getfinderliverecordlist 只返回「当前在播」，历史数据必须走 getlivelist。
• 权限未开启返回 errcode: 48001；errcode: 1 多半是 ds 传成了字符串。
• 技能不内置任何账号凭证；若用户在对话中明文发出 AppSecret，应提示去后台重置。