← Back to Skills Marketplace
12266
Downloads
18
Stars
0
Active Installs
15
Versions
Install in OpenClaw
/install google-analytics
Description
Google Analytics API integration with managed OAuth. This skill includes two separate APIs: the Admin API (write-capable — can create, update, and delete accounts, properties, and data streams) and the Data API (read-only — runs reports on sessions, users, page views, and conversions). Prefer the Data API connection for reporting-only tasks. Use the Admin API only when administrative changes are explicitly needed. All Admin API write operations require explicit user approval with specific resource identifiers before execution. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install this only if you are comfortable routing Google Analytics access through Maton. Prefer the read-only Data API connection for reports, create an Admin API connection only for administrative tasks, and require exact resource IDs plus explicit confirmation before any write or deletion.
Capability Assessment
Credentials
The skill requires network access and OAuth or API-key authentication to Maton, which is proportionate for an API integration. The raw HTTP fallback is broader because it handles a long-lived API key, but it is documented as a last resort with clear handling rules.
Install Mechanism
Installation is limited to documented Maton CLI or SDK package installs; the artifact contains no bundled executable scripts or hidden install behavior.
Instruction Scope
The instructions repeatedly require read/list operations first, specific resource identifiers, and explicit user confirmation before connection creation or any POST, PUT, PATCH, or DELETE operation.
Persistence & Privilege
OAuth tokens or API keys persist in the OS credential store or Maton/SDK session storage, which is expected for managed authentication. The skill warns not to inspect, print, persist, or transmit secrets outside api.maton.ai.
Purpose & Capability
The capability matches the stated purpose: Google Analytics Data API reporting plus Admin API management. Write-capable Admin API access is clearly disclosed as high-impact and directed toward Analytics accounts, properties, and data streams.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-analytics - After installation, invoke the skill by name or use
/google-analytics - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.3
Extract only the needed account fields in the raw HTTP fallback example instead of printing the whole response body
v1.2.2
Fix the raw HTTP fallback example: restore the gateway base URL in the GATEWAY constant (and the fastmail streaming call), which a previous edit had replaced with a placeholder
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.12
- Clarified distinction between Admin API (write-capable, for configuration changes) and Data API (read-only, for reporting).
- Made Data API the preferred/default connection for report queries; use Admin API only when administrative changes are needed.
- Updated security guidance: All Admin API write operations now require explicit user approval with resource identifiers and clear confirmation steps.
- Improved explanations throughout for safer handling of connections and to reduce accidental configuration changes.
- Expanded usage notes to emphasize the impact and correct choice of API connection for each task.
v1.0.11
- Changed all example and API endpoint URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for consistency and updated documentation.
- Clarified in documentation that if you have multiple connections, always specify the Maton-Connection header to target the correct Google Analytics account.
- Expanded the Security & Permissions section to remind users that all write operations require explicit user approval.
- Removed the LICENSE.txt file from the repository.
v1.0.10
- Added clawdbot metadata with required environment variable (MATON_API_KEY) and emoji.
- No code or functional changes.
v1.0.9
- Documentation (SKILL.md) updated with reference and code samples for using the Google Analytics Admin and Data APIs.
- No changes to code or functionality; documentation only.
v1.0.8
- Updated all cURL command examples to use Python code snippets for interacting with the API.
- Improved quick start and connection management sections with Python-based usage examples.
- No changes to functionality or API endpoints; documentation improvements only.
v1.0.7
Initial release of Google Analytics skill:
- Integrates Google Analytics Admin and Data APIs with managed OAuth.
- Enables management of accounts, properties, and data streams.
- Supports running reports on key metrics (sessions, users, page views, conversions).
- Includes detailed setup guides for authentication and connection management.
- Provides example API requests and references for common tasks.
v1.0.4
- Initial release of the Google Analytics skill with managed OAuth.
- Supports both Admin API (manage accounts, properties, data streams) and Data API (run reports on metrics).
- Provides detailed setup and authentication instructions using the Maton API key.
- Includes comprehensive API references, example commands, and guidance for common reporting use cases.
v1.0.2
- Added a note in the description directing users to use the api-gateway skill for third-party apps other than Google Analytics.
- Updated shell command examples to use the $MATON_API_KEY environment variable instead of static placeholders.
v1.0.1
- Clarified API gateway endpoint paths to use `{native-api-path}` for consistency with native Google Analytics API endpoints.
- Added details about specifying a connection using the `Maton-Connection` header when multiple connections exist.
- Included additional response fields (`creation_time`, `last_updated_time`, `metadata`) in connection details.
- Improved API key instructions, recommending account creation if needed.
- Minor edits for clarity and updated language in authentication and usage instructions.
v1.0.0
Initial release of Google Analytics API integration skill.
- Supports both the Google Analytics Admin API (manage accounts, properties, data streams) and Data API (run reports)
- Uses managed OAuth authentication via the Maton gateway
- Includes endpoints and code examples for configuring OAuth connections, managing resources, and running analytics reports
- Comprehensive usage documentation for commands, parameters, and common use cases
- Requires a valid Maton API key and network access
Metadata
Frequently Asked Questions
What is google-analytics?
Google Analytics API integration with managed OAuth. This skill includes two separate APIs: the Admin API (write-capable — can create, update, and delete accounts, properties, and data streams) and the Data API (read-only — runs reports on sessions, users, page views, and conversions). Prefer the Data API connection for reporting-only tasks. Use the Admin API only when administrative changes are explicitly needed. All Admin API write operations require explicit user approval with specific resource identifiers before execution. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 12266 downloads so far.
How do I install google-analytics?
Run "/install google-analytics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is google-analytics free?
Yes, google-analytics is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does google-analytics support?
google-analytics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created google-analytics?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.3.
More Skills