# Google Analytics MCP 或 API：GA4 的流量与行为报表，由你的 agent 读取

把你已有的 GA4 媒体资源接进来，agent 就能跑 Data API 能跑的任何报表：按渠道、页面、国家、设备或日期查看会话、用户、转化和事件，支持筛选与排序，用大白话就能提。这是不需要 Cloud 项目的 Google Analytics API。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「用鹦鹉AI 给我看截至 3 天前、最近 28 天按默认渠道组拆分的会话数和关键事件，并与再往前 28 天并排对比，把跌幅超过五分之一的渠道标出来。」

- **连一次就行** 能用这个媒体资源的 Google 账号走一次授权页。不用 Cloud 项目，不用服务账号。
- **指明媒体资源，或让它自己列** 一个 Google 账号常常能看到多个 GA4 媒体资源。agent 可以列出来问你。
- **时间窗别截至昨天** GA4 对最近几天仍在持续处理。截止到昨天的窗口，数据还在稳定中。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `google-analytics.report` — 按媒体资源 ID 运行自定义 GA4 报告 (google-analytics): https://parrot.amorist.cn/catalog/google-analytics

## 大家实际卡在哪

2026 年 8 月的约 75 篇相关帖子中，约 34 篇是又一个 GA4 MCP 或看板的上线帖，其中几篇一字不差地发在五个 subreddit。下面这四条，是在求这东西的人，不是卖这东西的人。

**人们正点名要的就是这个**

> "有哪些 AI agent 工具可以接上 Google Analytics API，并让我通过聊天式的对话界面取数据" (r/GoogleAnalytics, 17 points: https://www.reddit.com/r/GoogleAnalytics/comments/1vpw1m9/what_ai_agent_tools_can_i_use_to_connect_to_the/)

这一页能帮上的： 任何一个都行 —— 只要 agent 能连上一个已连接的媒体资源。本页这条设置行做的就是这个：agent 拿到的是报告调用，而令牌留在 鹦鹉AI 这边。

**手写这个 API 调用会失败，就算有人帮忙也一样**

> "我向 6 个大模型要了代码示例，得到 6 个不同的答案，没有一个能成功完成那次 API 调用。" (r/dataengineering: https://www.reddit.com/r/dataengineering/comments/1im3fpx/does_anyone_know_how_to_export_the_audience/)

这一页能帮上的： 请求体才是难的那部分，而在这里没有人需要手写它。agent 从问题出发把它构造出来、运行它，再把它展示回来，所以一个写错的维度名会是一个看得见的错误，而不是一个无声的错误。

**API 和界面给出的数字对不上**

> "界面显示同一个页面的事件计数是 2.2M，而 API 说只有 495k。" (r/GoogleAnalytics: https://www.reddit.com/r/GoogleAnalytics/comments/vwhssp/ga4_data_api_vs_interface_discrepancy/)

这一页能帮上的： 没有任何中转层能解决这件事，本页也不会声称能。对两个范围不同的请求来说，两个数字都可能是对的。agent 补上的是请求本身，而且摊开给你看，于是你能看清是哪种写法产生了哪个数字。

**数据明明显示在屏幕上，却还是拿不到**

> "我总觉得自己在 GA4 里漏掉了什么明摆着的东西，明明我都能看见那份数据就在那儿，却不知道怎么把它拿出来" (r/GoogleAnalytics: https://www.reddit.com/r/GoogleAnalytics/comments/1n09huf/export_daily_views_data_for_a_single_page/)

这一页能帮上的： 单个页面的每日浏览量，在 API 上就是一个两行定义的报告：一个日期维度、一个页面筛选、一个浏览量指标。用这些话直接问它，agent 就会把表格返回给你，不用走那一套导出的仪式。

## 真正不一样的地方

- 在 GA4 上把 agent 接起来的官方路径，是 Google 自家的 Analytics MCP server；它的配置要一个 Cloud 项目、一个启用了该 API 的服务账号，以及在媒体资源上的管理员权限。这里应用是鹦鹉AI 的，授权只有一个页面，媒体资源的只读权限就够了——所以一个并不拥有该账号的顾问也能用。
- 总数会随你请求的维度而变，这是 GA4 的性质，不是中转层的问题。一个按会话口径统计的指标，一旦按事件口径的维度拆开，计数就不同了；而 API 对同一个请求返回的结果与界面完全一致。当数字跟你记忆里的报表对不上，让 agent 把两种口径都跑一遍并显示请求本身，而不是先假定哪个错了。
- API 只能返回媒体资源还保留着的数据。GA4 默认只保留两个月的事件级数据，所以超出这个窗口的同比或同期群问题，从 API 取回来和从 Explore 里看一样是空的。Data API 还对每个媒体资源按小时、按天执行 token 配额，因此维度组合很多的宽报表比窄报表更耗配额；agent 在对每个页面跑循环之前应该先问一句。

## 什么是 Google Analytics API？

Google Analytics Data API 是 GA4 的编程接口：你提交媒体资源 id、日期范围、维度、指标和可选筛选，它返回的就是界面上「报表」和「探索」两个视图所依据的那些行。数据是同一份，但没有 Explore 在日期范围或抽样池上的限制；之所以要通过 agent 来读，是因为请求体里那些维度和指标名既琐碎又容易手写出细微错误。

## 开始之前

**能跑哪些报表？** runReport 接受的都能跑：任意维度与指标组合、日期范围、筛选、排序和分页。实时访客是另一个调用，在菜单里相邻的那一行。

**它会把看起来不对的数字修正吗？** 不会。如果埋点或同意设置喂给 GA4 的就是错误事件，API 返回的也是同样错误的数字。agent 能把它发出的请求显示给你看，那是查清原因的起点。

HTML 版本： https://parrot.amorist.cn/use-cases/google-analytics-traffic-and-behaviour-reports