mcpField
P
pp-google-analytics

pp-google-analytics

github.com/mvanhorn营销与增长2.1k148 次安装今天更新
代码仓库

关于 pp-google-analytics

pp-google-analytics 是指导 Agent 使用 google-analytics-pp-cli 查询 GA4 数据的技能，涵盖报告、比较和访问诊断，并将 GA4 工作与 Search Console 区分开。

主要功能

  1. 01GA4 属性报告
  2. 02获客与收入汇总
  3. 03漏斗和周期比较
  4. 04异常与访问诊断

适用场景

  1. 01查看渠道表现
  2. 02比较不同时期的会话或收入
  3. 03排查属性访问错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-google-analytics

安装后在 Claude Code 中输入/pp-google-analytics确认已加载。

详细介绍

pp-google-analytics

前置条件：安装 CLI

此技能使用 google-analytics-pp-cli 二进制文件。调用此技能中的任何命令前，必须确认 CLI 已安装。 如果尚未安装，请先安装：

  1. 使用 Printing Press 安装程序将其安装到用户的 bin 目录： 
    npx -y @mvanhorn/printing-press-library install google-analytics --cli-only --bin-dir ~/.local/bin
  2. 验证：google-analytics-pp-cli --version
  3. 确保调用此技能的 Agent／运行时的 $PATH 中包含 ~/.local/bin。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）。安装位置为 $GOPATH/bin（默认为 $HOME/go/bin），因此请改为将该目录添加到 $PATH：

go install github.com/mvanhorn/printing-press-library/library/marketing/google-analytics/cmd/google-analytics-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到该二进制文件所在目录。验证成功前，请勿执行技能命令。

何时使用此 CLI

当 Agent 需要 GA4 实时属性数据、获客／收入摘要、电商诊断、漏斗、周期对比、异常扫描或属性访问诊断时，使用此 CLI。Search Console 请使用 google-search-console-pp-cli。

GA4 专属分析工作请使用 google-analytics-pp-cli。Search Console 由 google-search-console-pp-cli 负责；新的工作请勿使用旧版 GSC／GA4 组合 CLI。

身份验证和属性选择

  • 服务账号密钥：使用 --credentials，否则使用 GOOGLE_APPLICATION_CREDENTIALS。
  • 范围：https://www.googleapis.com/auth/analytics.readonly。
  • 属性：传入 --property，或设置 GA4_PROPERTY_ID。
  • 全量健康检查：使用 health --properties $GA4_PROPERTY_IDS --agent，或设置 GA4_PROPERTY_IDS。

需要牢记的一点：Google Cloud API 访问权限不等于 GA4 属性访问权限。必须在 GA4 属性中授予服务账号 Viewer 权限。如果 health 显示令牌／管理员检查正常，但属性检查返回 403／404，请修复 GA4 属性授权，而不是轮换凭据。

适用于 Agent 的最佳命令

google-analytics-pp-cli agent-context --agent
google-analytics-pp-cli health --properties $GA4_PROPERTY_IDS --agent
google-analytics-pp-cli channels --property "$GA4_PROPERTY_ID" --start 28daysAgo --end yesterday --agent
google-analytics-pp-cli sources --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli top-pages --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli compare --property "$GA4_PROPERTY_ID" --metric sessions,totalRevenue --period wow --agent
google-analytics-pp-cli whats-changed --property "$GA4_PROPERTY_ID" --agent
google-analytics-pp-cli revenue --property "$GA4_PROPERTY_ID" --by channel --agent
google-analytics-pp-cli funnel --property "$GA4_PROPERTY_ID" --steps view_item,add_to_cart,begin_checkout,purchase --agent

原始封装命令

report、pivot、batch、realtime、metadata、compatibility、properties、property 和 streams 可作为低级备用方案使用。回答业务问题时，优先使用新式命令。

评论

支持 Markdown