# Send Plausible 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",
    "name": "Plausible",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/plausible",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/plausible",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/plausible",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "memory-template.md",
      "setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "plausible",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T04:39:41.517Z",
      "expiresAt": "2026-05-14T04:39:41.517Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=plausible",
        "contentDisposition": "attachment; filename=\"plausible-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "plausible"
      },
      "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"
    },
    "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",
    "downloadUrl": "https://openagent3.xyz/downloads/plausible",
    "agentUrl": "https://openagent3.xyz/skills/plausible/agent",
    "manifestUrl": "https://openagent3.xyz/skills/plausible/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/plausible/agent.md"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for integration guidelines.

### When to Use

User needs website traffic data from Plausible. Agent queries visitors, pageviews, referrers, goals, and custom events through the Plausible API.

### Architecture

Memory lives in ~/plausible/. See memory-template.md for structure.

~/plausible/
├── memory.md     # Sites + preferences (no secrets stored)
└── queries/      # Saved query templates (optional)

### Quick Reference

TopicFileSetup processsetup.mdMemory templatememory-template.md

### 1. API Key from Environment

API key comes from PLAUSIBLE_API_KEY environment variable. Never hardcode or ask user to paste keys in chat.

### 2. Site ID Required

Every query needs a site_id (domain). Check memory.md for configured sites before asking.

### 3. Time Periods

Default to 30d unless user specifies. Valid periods: day, 7d, 30d, month, 6mo, 12mo, custom (requires date/date_range).

### 4. Metrics Available

MetricDescriptionvisitorsUnique visitorsvisitsTotal sessionspageviewsTotal page viewsviews_per_visitPages per sessionbounce_rateSingle-page visits %visit_durationAvg session length (seconds)eventsCustom event countconversion_rateGoal conversion % (requires goal filter)

### 5. Breakdown Dimensions

DimensionDescriptionevent:pagePagesevent:nameCustom eventsvisit:sourceTraffic sourcesvisit:referrerFull referrer URLsvisit:utm_sourceUTM sourcevisit:utm_mediumUTM mediumvisit:utm_campaignUTM campaignvisit:deviceDesktop/Mobile/Tabletvisit:browserBrowser namevisit:osOperating systemvisit:countryCountry codevisit:cityCity name

### 6. Filters Syntax

Filters use format: dimension==value or dimension!=value. Multiple filters with ; (AND).

visit:source==Google
event:page==/pricing;visit:country==US

### 7. Rate Limits

600 requests/hour per API key. Cache results in memory when doing multiple queries.

### Common Traps

Forgetting site_id → API returns 400
Using wrong date format for custom range → use YYYY-MM-DD
Requesting conversion_rate without goal filter → returns null
Querying breakdown without metrics → defaults to visitors only

### External Endpoints

EndpointData SentPurposehttps://plausible.io/api/v1/stats/realtime/visitorssite_idRealtime counthttps://plausible.io/api/v1/stats/aggregatesite_id, metrics, period, filtersAggregate statshttps://plausible.io/api/v1/stats/timeseriessite_id, metrics, period, intervalTime serieshttps://plausible.io/api/v1/stats/breakdownsite_id, property, metrics, filtersBreakdown by dimension

Self-hosted instances use custom base URL from memory.md.

No other data is sent externally.

### Security & Privacy

Data that leaves your machine:

Site ID (domain) and query parameters sent to Plausible API
API key sent as Bearer token

Data that stays local:

Query results cached in memory
Site configurations in ~/plausible/

This skill does NOT:

Store API keys in plain text (uses environment variable)
Send user data beyond what's needed for queries
Access files outside ~/plausible/

### Trust

By using this skill, your site analytics queries are sent to Plausible (plausible.io or your self-hosted instance).
Only install if you trust Plausible with your domain data.

### Related Skills

Install with clawhub install <slug> if user confirms:

analytics — general analytics guidance
umami — alternative privacy analytics
mixpanel — product analytics

### Feedback

If useful: clawhub star plausible
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- 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-07T04:39:41.517Z
- Expires at: 2026-05-14T04:39:41.517Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/plausible)
- [Send to Agent page](https://openagent3.xyz/skills/plausible/agent)
- [JSON manifest](https://openagent3.xyz/skills/plausible/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/plausible/agent.md)
- [Download page](https://openagent3.xyz/downloads/plausible)