Community研究与数据分析github.com

The-AlexLiu/GA4-Reader-Skill

让飞书 Aily 与 WorkBuddy 通过自然语言安全读取 GA4 的双平台 Skill 与 Reader API

GA4-Reader-Skill 是什么?

GA4-Reader-Skill is a Claude Code agent skill that 让飞书 Aily 与 WorkBuddy 通过自然语言安全读取 GA4 的双平台 Skill 与 Reader API.

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add The-AlexLiu/GA4-Reader-Skill

Installed? Explore more 研究与数据分析 skills: obra/superpowers, affaan-m/quarkus-verification, affaan-m/uspto-database · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

GA4 Reader for Feishu Aily

使用管理员配置的 GA4 Reader HTTP 操作读取数据,并输出中文数据分析。

连接要求

开始查询前确认当前 Aily 应用存在以下 HTTP 操作:

  • Method:POST
  • Endpoint:<GA4_READER_API_URL>/v1/report
  • Secret Header:X-GA4-READER-TOKEN

若 HTTP 操作不存在,立即停止并提示管理员完成 Reader API 配置。不要安装 gcloud、Python 包或 MCP,不要发起 Google OAuth、设备码登录或浏览器登录。

Token 只能存在于 Aily 私密连接配置中。不得复述、打印、写入 URL、请求正文、Skill 或最终回答。

查询规则

  1. 请求体使用 GA4 Data API runReport JSON。
  2. Property 由服务端固定,不在请求中传入。
  3. 用户漏斗优先使用 totalUsers,事件埋点诊断才使用 eventCount
  4. 当天数据标记为未完整,并说明 Property 时区。
  5. CVR = transactions / sessions
  6. AOV = purchaseRevenue / transactions
  7. Revenue per Session = purchaseRevenue / sessions
  8. 维度行中的用户可能重复,不把行级 Users 相加当作全站唯一用户数。
  9. 样本量过小时标记“需观察”,不得给出强结论。

详细查询字段和示例见 references/query-guide.md

输出要求

  • 使用中文,先给结论,再给表格,最后给行动建议。
  • 明确日期、时区、货币、维度、指标和过滤条件。
  • 区分确认事实、可能原因和待确认信息。
  • 行级结果优先使用 Markdown 表格或 TSV。
  • 不编造接口没有返回的指标。

相关技能