📦 Ga4 Data Api — GA4数据查询

Name: Ga4 Data Api — GA4数据查询
Rating: 1

v0.1.0

通过Google Analytics Data API查询GA4数据，支持趋势、国家、来源、页面与转化分析，一键OAuth授权即可用。

1· 222·2 当前·2 累计

by @nanaco666 (nanaco)·MIT-0

数据分析 API工具云服务开发工具自动化

下载技能包

License

MIT-0

最后更新

2026/3/12

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

The skill is internally consistent with its stated purpose (querying GA4 via the Data API using OAuth); it installs expected Python deps, stores OAuth client/token in the user's config, and modifies the user's shell RC to persist GA4_PROPERTY_ID.

评估建议

This skill appears to do what it says: it uses OAuth to query GA4 and stores the OAuth client JSON and tokens under ~/.config/openclaw. Before installing: review and keep the client-secret JSON private, and be prepared that the installer will (1) install Python packages from PyPI, (2) copy your client JSON into ~/.config/openclaw, and (3) add or update an export GA4_PROPERTY_ID line in your shell rc (~/.bashrc or ~/.zshrc). Confirm you will sign in with the Google account that actually has acces...

详细分析 ▾

✓ 用途与能力

名称与描述与所含代码及说明一致：Python脚本与安装助手专为通过OAuth及Google Analytics Data API查询GA4设计，所需操作（安装google-analytics-data库、保存客户端JSON、缓存令牌）与技能目的相称。

ℹ 指令范围

运行时指令仅涉及GA4设置与查询，明确采用OAuth用户流程；指引运行提供的安装与查询脚本。轻微不一致：安装脚本最终回显的ga4_query.py路径与其他文档略有差异（可能为复制粘贴错误），此外未索要无关文件或凭据。

ℹ 安装机制

注册表无平台安装规范，但附带的安装脚本执行'python3 -m pip install --user ...'从PyPI拉取包，并将提供的客户端密钥JSON复制到~/.config/openclaw。对Python版GA4客户端属预期行为，但会执行网络安装并在用户主目录写入文件。

ℹ 凭证需求

技能在注册元数据中不要求外部凭据，代码使用本地客户端密钥JSON并将OAuth令牌存于~/.config/openclaw/ga4-token.json——符合OAuth规范。安装脚本还通过向shell rc写入export持久化GA4_PROPERTY_ID，方便但属用户应预期的持久变更。

ℹ 持久化与权限

技能向~/.config/openclaw写入文件，并在用户shell rc（~/.bashrc或~/.zshrc）追加/更新export GA4_PROPERTY_ID。未设置always:true或修改其他技能。自行写配置与缓存令牌属正常，但具有本地持久性。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv0.1.02026/3/12

- Initial release of the GA4 Data API skill for OpenClaw. - Enables querying Google Analytics 4 data using OAuth user authorization. - Guides users through access verification, credential setup, and example queries. - Emphasizes checking account permissions before setup and clarifies common access issues. - Provides ready-to-use command-line examples for analyzing trends, country/source breakdowns, and conversions. - Recommends best practices for analysis and directs to included setup and usage references.

● 无害

安装命令

点击复制

官方npx clawhub@latest install ga4-data-api

镜像加速npx clawhub@latest install ga4-data-api --registry https://cn.longxiaskill.com

技能文档

# GA4 Data API 使用该技能通过 OAuth 用户授权设置并查询 GA4。 ## 默认方法优先使用 OAuth 用户授权。在常规路径中使用 scripts/install_ga4_openclaw.sh + scripts/ga4_query.py。只有当明确需要无头/服务器端访问时，才建议后续使用 service accounts。 ## 硬性规则 1. 设置前检查账户与权限 - 询问哪个 Google 账户能真正登录 GA 并拥有媒体/账户访问权限。 - 对于企业/内部数据，默认不要一上来就用 service-account 设置。 2. 如实说明阻碍 - 如果用户无法添加用户，就说这是权限阻碍。 - 如果 OAuth 应用仍在测试阶段，就说必须把账户加入测试用户列表。 - 如果用户能看到媒体但缺乏管理员控制，就说这是访问级别问题，而不是假装按钮被隐藏。 ## 设置流程 ### 第 1 步 — 验证访问模型询问/确认： - 哪个 Google 账户拥有 GA 访问权限？ - 用户能否登录该账户？ - GA4 Property ID 是什么？ - Google Analytics Data API 是否已启用？ - 是否已有 Desktop OAuth 客户端 JSON？ ### 第 2 步 — 安装并接入凭据运行： ``bash bash ~/.openclaw/workspace/skills/ga4-data-api/scripts/install_ga4_openclaw.sh ` 这会安装 Python 依赖，将 OAuth 客户端 JSON 复制到 ~/.config/openclaw/ga4-client.json，并把 GA4_PROPERTY_ID 写入 shell 配置。 ### 第 3 步 — 首次授权运行： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers,sessions \ --dimensions date \ --start 7daysAgo \ --end today \ --pretty ` 浏览器会打开。用户必须选择真正拥有 GA 访问权限的同一个 Google 账户。授权成功后会生成： - ~/.config/openclaw/ga4-token.json ### 第 4 步 — 查询示例最近趋势： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers,sessions \ --dimensions date \ --start 7daysAgo \ --end yesterday \ --pretty ` 国家分布： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers \ --dimensions country \ --start 7daysAgo \ --end yesterday \ --limit 50 \ --pretty ` 来源分布： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics sessions \ --dimensions sessionSourceMedium \ --start 7daysAgo \ --end yesterday \ --limit 50 \ --pretty ` ## 分析指导趋势类问题： - 优先使用整天（end=yesterday），除非用户明确要求当天日内。 - 指出当天下降可能只是部分数据所致。转化类问题： - 区分流量事件与真正转化事件。 - 如果 key events 范围太宽，建议在得出产品结论前先缩小事件集。 ## 参考资料 - 当用户需要可分享的设置流程时，阅读 references/setup.md。 - 每次查询都用 scripts/ga4_query.py`，而不是手写新的 GA SDK 示例。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库