Frontier Now
搜索

营销#数据分析#网站检测

Google Analytics MCP：让智能体直接查 GA4 报表

Google Analytics 官方 MCP：智能体通过 GA4 API 跑常规、漏斗和实时报表，只申请只读权限，适合想用自然语言查流量的运营和站长。

作者
Frontier Now 编辑部
发布

项目与安装文档

查看项目

https://github.com/googleanalytics/google-analytics-mcp

GA4 的报表界面出了名地难找：想看“过去 180 天哪些事件最多”“登录用户占比多少”，得在探索报告里拖半天维度和指标。Google Analytics MCP 是 Google Analytics 团队官方维护的 MCP 服务器，智能体直接调用 GA4 的 Admin API 和 Data API，用一句话就能出这些报表。截至 2026-10-06 约 3400 star。

能做什么

  • 账户和媒体资源：get_account_summaries 列出你能访问的所有账户和媒体资源，get_property_details 查单个资源的配置，list_google_ads_links 看关联了哪些 Google Ads 账户。
  • 常规报表：run_report 按维度和指标跑 Data API 报表，get_custom_dimensions_and_metrics 先读出自定义维度，免得模型猜字段名。
  • 漏斗报表：run_funnel_report 跑转化漏斗，看用户在哪一步流失。
  • 实时数据：run_realtime_report 查当前在线用户和实时事件，适合活动上线时盯数据。

适合谁

  • 内容站站长和独立开发者，想直接问“上周哪篇文章带来的新用户最多”。
  • 增长和投放运营，想让智能体把 GA4 数据和 Google Ads 关联情况一起整理成周报。
  • 不熟悉 GA4 探索报告的产品经理，想用自然语言做漏斗分析。

接入方式

需要 pipx，在 Google Cloud 项目里启用 Analytics Admin API 和 Data API，并用 gcloud auth application-default login 配好带 analytics.readonly 范围的应用默认凭据（ADC）。Claude Code：

claude mcp add analytics-mcp \
  --scope user \
  -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \
  -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID" \
  -- pipx run analytics-mcp

编辑点评

分析类 MCP 里，这个是官方的，而且只申请只读范围，智能体改不了任何配置，放心交给它查数据。门槛主要在前期：要建 Google Cloud 项目、启用两个 API、配 OAuth 客户端和 ADC，对不熟悉 GCP 的人来说比装服务器本身麻烦。项目仍标注为实验性（Experimental），工具只有七个，管理类操作（建事件、改转化）都不在范围内。README 的示例以 Gemini CLI 为主，Claude Code 的命令也已给出。许可证为 Apache-2.0。