# Send Supermetrics to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "supermetrics-openclawd",
    "name": "Supermetrics",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/bartschneider/supermetrics-openclawd",
    "canonicalUrl": "https://clawhub.ai/bartschneider/supermetrics-openclawd",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/supermetrics-openclawd",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=supermetrics-openclawd",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "supermetrics.py",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "supermetrics-openclawd",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T13:56:17.221Z",
      "expiresAt": "2026-05-16T13:56:17.221Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=supermetrics-openclawd",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=supermetrics-openclawd",
        "contentDisposition": "attachment; filename=\"supermetrics-openclawd-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "supermetrics-openclawd"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/supermetrics-openclawd"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/supermetrics-openclawd",
    "downloadUrl": "https://openagent3.xyz/downloads/supermetrics-openclawd",
    "agentUrl": "https://openagent3.xyz/skills/supermetrics-openclawd/agent",
    "manifestUrl": "https://openagent3.xyz/skills/supermetrics-openclawd/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/supermetrics-openclawd/agent.md"
  }
}
```
## Documentation

### Supermetrics Marketing Data

Query marketing data from 100+ platforms including Google Analytics, Meta Ads, Google Ads, and LinkedIn.

### Usage

Import the helper module:

from supermetrics import (
    discover_sources,
    discover_accounts,
    discover_fields,
    query_data,
    get_results,
    get_today,
    search,
    health,
)

### discover_sources()

List all available marketing platforms.

result = discover_sources()
for src in result['data']['sources']:
    print(f"{src['id']}: {src['name']}")

### discover_accounts(ds_id)

Get connected accounts for a data source.

Common data source IDs:

IDPlatformFAMeta Ads (Facebook)AWGoogle AdsGAWAGoogle AnalyticsGA4Google Analytics 4LILinkedIn AdsACMicrosoft Advertising (Bing)

result = discover_accounts("GAWA")
for acc in result['data']['accounts']:
    print(f"{acc['account_id']}: {acc['account_name']}")

### discover_fields(ds_id, field_type=None)

Get available metrics and dimensions.

# Get all fields
result = discover_fields("GAWA")

# Get only metrics
result = discover_fields("GAWA", "metric")

# Get only dimensions
result = discover_fields("GAWA", "dimension")

### query_data(...)

Execute a marketing data query. Returns schedule_id for async retrieval.

result = query_data(
    ds_id="GAWA",
    ds_accounts="123456789",
    fields=["date", "sessions", "pageviews", "users"],
    date_range_type="last_7_days"
)
schedule_id = result['data']['schedule_id']

Parameters:

ds_id (required): Data source ID
ds_accounts (required): Account ID(s) from discover_accounts()
fields (required): Field ID(s) from discover_fields()
date_range_type: last_7_days, last_30_days, last_3_months, custom
start_date, end_date: For custom date range (YYYY-MM-DD)
filters: Filter expression (e.g., "country == United States")
timezone: IANA timezone (e.g., "America/New_York")

Filter operators:

==, != - equals, not equals
>, >=, <, <= - comparisons
=@, !@ - contains, does not contain
=~, !~ - regex match

### get_results(schedule_id)

Retrieve query results.

result = get_results(schedule_id)
for row in result['data']['data']:
    print(row)

### get_today()

Get current UTC date for date calculations.

result = get_today()
print(result['data']['date'])  # "2026-02-03"

### search(query)

Search across Supermetrics resources for guidance and suggestions.

result = search("facebook ads metrics")
print(result['data'])

### health()

Check Supermetrics server health status.

result = health()
print(result['data']['status'])  # "healthy"

### Workflow Example

from supermetrics import (
    discover_accounts,
    discover_fields,
    query_data,
    get_results,
)

# 1. Find accounts
accounts = discover_accounts("GAWA")
account_id = accounts['data']['accounts'][0]['account_id']

# 2. See available fields
fields = discover_fields("GAWA", "metric")
print([f['id'] for f in fields['data']['metrics'][:5]])

# 3. Query data
query = query_data(
    ds_id="GAWA",
    ds_accounts=account_id,
    fields=["date", "sessions", "users", "pageviews"],
    date_range_type="last_7_days"
)

# 4. Get results
data = get_results(query['data']['schedule_id'])
for row in data['data']['data']:
    print(row)

### Response Format

All functions return:

{"success": True, "data": {...}}  # Success
{"success": False, "error": "..."}  # Error
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bartschneider
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-09T13:56:17.221Z
- Expires at: 2026-05-16T13:56:17.221Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/supermetrics-openclawd)
- [Send to Agent page](https://openagent3.xyz/skills/supermetrics-openclawd/agent)
- [JSON manifest](https://openagent3.xyz/skills/supermetrics-openclawd/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/supermetrics-openclawd/agent.md)
- [Download page](https://openagent3.xyz/downloads/supermetrics-openclawd)