← 返回 Skills 市场

Google-analytics-GA4

Name: Google-analytics-GA4
Author: whosc

作者 whao · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

176

总下载

当前安装

版本数

在 OpenClaw 中安装

/install google-analytics-ga4

功能描述

Query Google Analytics GA4 properties for realtime and historical user metrics, dimensions, and metadata using the official Data API.

使用说明 (SKILL.md)

Google Analytics skill

Query GA4 properties using the Google Analytics Data API v1.

Capabilities

Realtime metrics — e.g. active users in the last N minutes
Historical reports — custom date ranges, metrics, dimensions, paging
Metadata — discover valid dimension and metric API names
Property list hint — Data API alone cannot enumerate properties; doc explains where to find the numeric ID

Setup

1. Create a service account

Open Google Cloud Console.
Create or select a project.
Enable Google Analytics Data API.
Create a service account: IAM & Admin → Service Accounts → Create service account.
- Optional GCP role: BigQuery Job User (only if you also use BigQuery).
Finish the wizard.

2. Create a JSON key

Open the service account → Keys.
Add key → Create new key → JSON.
Download the file and save it as ga-credentials.json (or any path you pass via --credentials / GOOGLE_APPLICATION_CREDENTIALS).

3. Grant GA4 access

Open Google Analytics.
Select the property.
Admin (gear) → Property access management.
Add users → enter the service account email (…@….iam.gserviceaccount.com).
Role: at least Viewer.

4. Credentials location

Either:

A. Place ga-credentials.json in this skill directory, or
B. Set GOOGLE_APPLICATION_CREDENTIALS to the absolute path of the JSON key.

Never commit real keys. .gitignore excludes ga-credentials.json and config.json.

Examples

Property list guidance

python ga_query.py --action list-properties

Realtime (active users)

python ga_query.py --action realtime \
  --property-id YOUR-GA4-PROPERTY-ID

Historical

python ga_query.py --action historical \
  --property-id YOUR-GA4-PROPERTY-ID \
  --start-date 7daysAgo \
  --end-date yesterday \
  --metrics activeUsers,sessions,eventCount \
  --dimensions country,deviceCategory

Metadata

python ga_query.py --action metadata \
  --property-id YOUR-GA4-PROPERTY-ID

Arguments

Common

Argument	Description	Default
`--property-id`	Numeric GA4 property ID	Required (except `list-properties`)
`--credentials`	Service account JSON path	`ga-credentials.json`

Realtime

Argument	Description	Default
`--metrics`	Comma-separated metrics	`activeUsers`
`--dimensions`	Comma-separated dimensions	(none)
`--minute-range`	Minutes ago window, e.g. `0-30`	`0-30`

Historical

Argument	Description	Default
`--start-date`	Start (`YYYY-MM-DD` or relative)	Required
`--end-date`	End	Required
`--metrics`	Comma-separated metrics	`activeUsers`
`--dimensions`	Comma-separated dimensions	(none)
`--limit`	Max rows	`10000`
`--offset`	Paging offset	`0`

Common metrics

Name	Meaning
`activeUsers`	Active users
`sessions`	Sessions
`eventCount`	Event count
`engagementRate`	Engagement rate
`averageSessionDuration`	Avg session duration (seconds)
`screenPageViews`	Page / screen views
`conversions`	Conversions
`totalRevenue`	Revenue

Common dimensions

Name	Meaning
`country`	Country
`city`	City
`deviceCategory`	desktop / mobile / tablet
`eventName`	Event name
`pagePath`	Page path
`source`	Traffic source
`medium`	Medium
`campaign`	Campaign
`date`	Date

Date expressions

Absolute: 2024-01-15
Relative: today, yesterday, 7daysAgo, 30daysAgo

Output

Default: Markdown tables. Use --output json for machine-readable output.

Dependencies

pip install google-analytics-data

Optional (traffic source report + DingTalk): pip install requests and set DINGTALK_WEBHOOK / DINGTALK_SECRET.

References

安全使用建议

This appears to be a legitimate GA4 reporting skill. Before installing: (1) do not commit real service-account JSON keys to repos; use a Viewer-limited service account; (2) check there is no unexpected ga-credentials.json with secrets in the skill directory (the repo includes an empty ga-credentials.json placeholder); (3) be aware some scripts set GOOGLE_APPLICATION_CREDENTIALS to the local ga-credentials.json which may override your global setting — remove or edit that line if you prefer a different path; (4) only set DINGTALK_WEBHOOK / DINGTALK_SECRET if you want outgoing notifications; and (5) review and run test_connection.py first to confirm permissions and quotas before doing large exports.

功能分析

Type: OpenClaw Skill Name: google-analytics-ga4 Version: 1.0.0 The bundle provides a legitimate set of tools for querying Google Analytics (GA4) data via the official Google Analytics Data API v1. It includes a main CLI tool (ga_query.py), an OpenClaw wrapper (openclaw_ga.py), and a reporting script (traffic_source_report.py) that can optionally send reports to a DingTalk webhook. All network activities and credential handling (via GOOGLE_APPLICATION_CREDENTIALS) are aligned with the stated purpose of the skill. No evidence of malicious intent, prompt injection, or unauthorized data exfiltration was found.

能力评估

✓ Purpose & Capability

Name/description (GA4 reporting) matches the included files (CLI, helper, tests, optional report). Required dependencies (google-analytics-data, requests optional) are appropriate for the functionality.

ℹ Instruction Scope

SKILL.md and code confine actions to creating/using a Google service account JSON key, calling the GA4 Data API, and optionally sending notifications (DingTalk) if the user configures webhook env vars. One small surprise: several scripts unconditionally set GOOGLE_APPLICATION_CREDENTIALS to ./ga-credentials.json which can override an existing environment variable — the docs mention both options, but the script behavior may be unexpected to some users.

✓ Install Mechanism

No automatic install/downloads or remote installers; dependencies are standard Python packages listed in requirements.txt. The package is shipped as source files (no opaque external payloads).

ℹ Credentials

The skill does not request unrelated secrets. It expects a Google service account JSON (GOOGLE_APPLICATION_CREDENTIALS or ga-credentials.json) and may use GA4_PROPERTY_ID or a config.json for property selection. Optional DingTalk webhook env vars are documented — these are reasonable but are unrelated to GA4 data access and should only be set if you intend to use notifications.

✓ Persistence & Privilege

Skill is not force-included (always:false) and does not modify other skills or global agent configuration. It runs on-demand and has no elevated platform privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install google-analytics-ga4
安装完成后，直接呼叫该 Skill 的名称或使用 /google-analytics-ga4 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Call the Google Analytics API from the command line to read GA4 data (not Universal Analytics).

元数据

Slug google-analytics-ga4

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题