The-AlexLiu GA4 Reader for WorkBuddy
通过团队 Reader API 只读查询 GA4。首次使用时读取 references/first-use.md。
连接检查
运行：
python3 scripts/ga4_reader.py --health
查询前确认 ~/.workbuddy/secrets/ga4-reader.json 已配置。只检查文件是否存在，不得打印 Token。若缺失，立即停止并引导用户运行配置脚本。不要安装 gcloud、Google SDK 或 MCP，不要发起 OAuth 或浏览器登录。
查询
将 GA4 Data API runReport 请求保存为 JSON，然后运行：
python3 scripts/ga4_reader.py --request /path/to/request.json
查询口径和输出要求见 references/query-guide.md。Property 由服务端固定，不得在请求中覆盖。
输出
- 使用中文，先给结论，再给数据表和行动建议。
- 明确日期范围、时区、货币、维度、指标和过滤条件。
- 用户漏斗优先使用
totalUsers；事件诊断才使用eventCount。 - CVR = transactions / sessions；AOV = purchaseRevenue / transactions。
- 不打印 API URL 配置中的 Token，不编造缺失数据。