# Send Plausible Analytics 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": "plausible-analytics",
    "name": "Plausible Analytics",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/ChloePark85/plausible-analytics",
    "canonicalUrl": "https://clawhub.ai/ChloePark85/plausible-analytics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/plausible-analytics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible-analytics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/stats.mjs",
      "scripts/realtime.mjs",
      "scripts/breakdown.mjs"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "plausible-analytics",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T00:41:32.970Z",
      "expiresAt": "2026-05-07T00:41:32.970Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible-analytics",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible-analytics",
        "contentDisposition": "attachment; filename=\"plausible-analytics-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "plausible-analytics"
      },
      "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/plausible-analytics"
    },
    "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/plausible-analytics",
    "downloadUrl": "https://openagent3.xyz/downloads/plausible-analytics",
    "agentUrl": "https://openagent3.xyz/skills/plausible-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/plausible-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/plausible-analytics/agent.md"
  }
}
```
## Documentation

### Overview

Retrieve and analyze website analytics data from Plausible Analytics API. Supports real-time visitor tracking, historical statistics, traffic source analysis, and detailed breakdowns by page, source, or country.

### Quick Start

All scripts require PLAUSIBLE_API_KEY environment variable. Site ID can be provided via PLAUSIBLE_SITE_ID environment variable or as a script argument.

# Set API key
export PLAUSIBLE_API_KEY="your-api-key"

# Quick example: Get today's stats
node scripts/stats.mjs example.com --period day

### Real-Time Visitors

Check how many people are currently viewing your site:

node scripts/realtime.mjs <site-id>

Example output:

{
  "visitors": 42
}

### Statistics

Get page views, visitors, bounce rate, and visit duration for a time period:

node scripts/stats.mjs <site-id> [--period day|7d|30d|month|6mo|12mo] [--date YYYY-MM-DD]

Parameters:

period - Time period to query (default: day)
date - Specific date for the period (default: today)

Example:

# Get today's stats
node scripts/stats.mjs example.com

# Get last 7 days
node scripts/stats.mjs example.com --period 7d

# Get stats for a specific month
node scripts/stats.mjs example.com --period month --date 2026-02-01

Example output:

{
  "results": {
    "visitors": {
      "value": 1234
    },
    "pageviews": {
      "value": 5678
    },
    "bounce_rate": {
      "value": 45
    },
    "visit_duration": {
      "value": 180
    }
  }
}

### Detailed Breakdown

Analyze traffic by specific dimensions (pages, sources, countries, etc.):

node scripts/breakdown.mjs <site-id> <property> [--period day|7d|30d] [--limit N]

Properties:

visit:source - Traffic sources (Google, Twitter, direct, etc.)
visit:referrer - Referring URLs
visit:utm_medium / visit:utm_source / visit:utm_campaign - UTM parameters
visit:device - Desktop vs Mobile
visit:browser - Browser breakdown
visit:os - Operating system
visit:country - Countries
event:page - Top pages

Example:

# Top 10 pages in the last 7 days
node scripts/breakdown.mjs example.com event:page --period 7d --limit 10

# Traffic sources today
node scripts/breakdown.mjs example.com visit:source

# Countries in the last 30 days
node scripts/breakdown.mjs example.com visit:country --period 30d

Example output:

{
  "results": [
    {
      "page": "/",
      "visitors": 542,
      "pageviews": 1024
    },
    {
      "page": "/about",
      "visitors": 123,
      "pageviews": 145
    }
  ]
}

### Environment Variables

PLAUSIBLE_API_KEY (required) - Your Plausible API key
PLAUSIBLE_SITE_ID (optional) - Default site ID to use

### scripts/

stats.mjs - Aggregate statistics for a time period
realtime.mjs - Current visitor count
breakdown.mjs - Detailed breakdown by dimension
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ChloePark85
- 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-04-30T00:41:32.970Z
- Expires at: 2026-05-07T00:41:32.970Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/plausible-analytics)
- [Send to Agent page](https://openagent3.xyz/skills/plausible-analytics/agent)
- [JSON manifest](https://openagent3.xyz/skills/plausible-analytics/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/plausible-analytics/agent.md)
- [Download page](https://openagent3.xyz/downloads/plausible-analytics)