π¦ ClawHub
Plausible Analytics Agent
by @kryzl19
Track pageviews and custom events via the Plausible Events API, and query stats (top pages, top sources, countries, realtime visitors). Use when you need to...
TERMINAL
clawhub install plausible-analytics-agentπ About This Skill
name: plausible-analytics description: Track pageviews and custom events via the Plausible Events API, and query stats (top pages, top sources, countries, realtime visitors). Use when you need to send analytics events or fetch analytics data from a self-hosted or plausible.io site. metadata: { "openclaw": { "emoji": "π", "requires": { "env": ["PLAUSIBLE_SITE_DOMAIN", "PLAUSIBLE_API_KEY"], }, }, }
Plausible Analytics
Track events and query stats from Plausible Analytics (self-hosted or plausible.io).
Configuration
Set these environment variables before use:
# Your site domain (e.g. example.com)
export PLAUSIBLE_SITE_DOMAIN="example.com"Your Plausible API key (for stats endpoints)
export PLAUSIBLE_API_KEY="your-api-key"Plausible base URL (default: https://plausible.io for hosted)
For self-hosted, set to your instance URL
export PLAUSIBLE_BASE_URL="https://plausible.io"
Track Pageview
bash skills/plausible-analytics/scripts/track.sh \
--domain "$PLAUSIBLE_SITE_DOMAIN" \
--url "https://example.com/blog/post-1" \
--referrer "https://google.com"
Options:
--domain β Site domain (default: $PLAUSIBLE_SITE_DOMAIN)--url β Page URL being viewed (required)--referrer β Referring URL (optional)--base-url β Plausible base URL (default: $PLAUSIBLE_BASE_URL)Track Custom Event
bash skills/plausible-analytics/scripts/track.sh \
--domain "$PLAUSIBLE_SITE_DOMAIN" \
--event "Signup" \
--props "{\"plan\":\"pro\",\"source\":\"newsletter\"}"
Options:
--domain β Site domain--event β Custom event name (e.g. "Signup", "Button Click")--props β JSON object with event properties (optional)--base-url β Plausible base URLGet Stats Summary
bash skills/plausible-analytics/scripts/stats.sh \
--domain "$PLAUSIBLE_SITE_DOMAIN" \
--period "30d" \
--compare "previous_period"
Options:
--domain β Site domain--period β Time period: 6mo, 12mo, day, 7d, 30d, month (default: 30d)--compare β Compare to previous period: previous_period (optional)--base-url β Plausible base URL (default: $PLAUSIBLE_BASE_URL)Returns: pageviews, unique visitors, bounce rate, visit duration, total pageviews
Get Top Pages
bash skills/plausible-analytics/scripts/top-pages.sh \
--domain "$PLAUSIBLE_SITE_DOMAIN" \
--period "30d" \
--limit 10
Options:
--domain β Site domain--period β Time period (default: 30d)--limit β Number of pages to return (default: 10)--base-url β Plausible base URLGet Realtime Visitors
bash skills/plausible-analytics/scripts/realtime.sh \
--domain "$PLAUSIBLE_SITE_DOMAIN"
Options:
--domain β Site domain--base-url β Plausible base URLReturns: current visitors on site, pageviews in last 30 min, top pages currently viewed
Notes
/api/event) is used without authentication for tracking/api/v1/stats) requires PLAUSIBLE_API_KEY set in the request headerPLAUSIBLE_BASE_URL to your instanceβοΈ Configuration
Set these environment variables before use:
# Your site domain (e.g. example.com)
export PLAUSIBLE_SITE_DOMAIN="example.com"Your Plausible API key (for stats endpoints)
export PLAUSIBLE_API_KEY="your-api-key"Plausible base URL (default: https://plausible.io for hosted)
For self-hosted, set to your instance URL
export PLAUSIBLE_BASE_URL="https://plausible.io"
π Tips & Best Practices
/api/event) is used without authentication for tracking/api/v1/stats) requires PLAUSIBLE_API_KEY set in the request headerPLAUSIBLE_BASE_URL to your instance