plausible-analytics_skill

Overview

This skill connects to the Plausible Analytics API to query and analyze website metrics. It provides real-time visitor counts, aggregate stats for chosen periods, and detailed breakdowns by pages, sources, countries, devices, and events. Use it to generate quick reports or to inspect traffic trends for sites tracked in Plausible.

How this skill works

The skill reads a Plausible API key from the environment and issues API requests for the selected site and time range. It supports endpoints for realtime visitors, aggregate statistics (visitors, pageviews, bounce rate, visit duration), and dimension breakdowns (source, referrer, country, page, device, etc.). Results are returned as structured JSON suitable for reporting, dashboards, or further processing.

When to use it

• Check current active visitors and concurrent traffic patterns.
• Fetch pageviews and visitor statistics for specific dates or periods (day, 7d, 30d, month, 6mo, 12mo).
• Analyze traffic sources, UTM campaigns, or referral domains to evaluate marketing performance.
• Identify top pages, countries, browsers, or devices for segmentation and optimization.
• Generate repeatable analytics reports or feed dashboards with Plausible metrics.

Best practices

• Set PLAUSIBLE_API_KEY in the environment and optionally PLAUSIBLE_SITE_ID to avoid passing credentials on the command line.
• Specify sensible periods for the query to limit API usage and keep responses performant (e.g., 7d or 30d for trend analysis).
• Use breakdown limits (limit N) when requesting dimensions to avoid huge payloads; paginate or aggregate locally if needed.
• Combine realtime checks with short-term historical queries to validate sudden traffic spikes or drops.
• Cache frequent queries for dashboards to reduce API calls and respect rate limits.

Example use cases

• Show current visitor count on an operations dashboard using the realtime endpoint.
• Produce a weekly report of visitors, pageviews, bounce rate, and average visit duration for stakeholder meetings.
• List top 10 pages over the last 7 days to prioritize content improvements.
• Analyze traffic sources and UTM parameters to measure campaign effectiveness.
• Break down visitors by country and device to tailor localization and responsive design efforts.