← Back to Skills Marketplace
kryzl19

Plausible Analytics Agent

by KRYZL19 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
147
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install plausible-analytics-agent
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...
Usage Guidance
This skill appears to do exactly what it says: call Plausible's Events and Stats APIs. Before installing, make sure: 1) you provide a Plausible API key with minimal required scope and rotate it regularly; 2) PLAUSIBLE_BASE_URL is set only to your Plausible instance or plausible.io (don't point it at unknown hosts, or events/stats could be sent elsewhere); 3) the agent environment has curl and jq available (the scripts use them but the bundle doesn't declare them); and 4) avoid including PII in custom event props since those are sent to the configured endpoint. If any of these are unacceptable, don't enable the skill or run the scripts in a controlled environment first.
Capability Analysis
Type: OpenClaw Skill Name: plausible-analytics-agent Version: 1.0.0 The plausible-analytics-agent skill is a legitimate tool for interacting with the Plausible Analytics API. It includes scripts (realtime.sh, stats.sh, top-pages.sh, track.sh) that use curl and jq to send and receive data from a user-configured Plausible instance. The implementation follows good practices, such as using jq's argument binding to prevent JSON injection and implementing standard error handling in Bash.
Capability Assessment
Purpose & Capability
Name and description match the scripts and behavior: the scripts call Plausible Events and Stats APIs and require PLAUSIBLE_SITE_DOMAIN and PLAUSIBLE_API_KEY. Minor inconsistency: the skill bundle does not declare required binaries, but the scripts use curl and jq — these should be documented as required.
Instruction Scope
SKILL.md and the scripts limit actions to building and sending requests to the Plausible base URL (default plausible.io) and printing JSON. They read only the declared env vars (plus the optional PLAUSIBLE_BASE_URL). No unrelated filesystem reads, local secrets, or external endpoints are hard-coded. Note: PLAUSIBLE_BASE_URL is user-configurable, so if set to an arbitrary URL it would direct events/stats to that host (this is expected but should be chosen carefully).
Install Mechanism
No install spec or remote downloads are present; this is an instruction-only skill with included shell scripts. No archives or external installers are fetched, which is low-risk.
Credentials
The skill requires PLAUSIBLE_SITE_DOMAIN and PLAUSIBLE_API_KEY which are appropriate for Plausible Stats calls. PLAUSIBLE_BASE_URL is used but optional and not listed in required env vars — that's acceptable but could be documented. The API key is used only in Authorization headers for stats/realtime/top-pages endpoints; the Events API is intentionally used unauthenticated per Plausible design.
Persistence & Privilege
always:false (default) and the skill does not request to modify other skills or system-wide settings. It does not persist credentials or install background services.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install plausible-analytics-agent
  3. After installation, invoke the skill by name or use /plausible-analytics-agent
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: Track pageviews and custom events, and fetch analytics stats from Plausible Analytics. - Supports both self-hosted and plausible.io setups. - Includes scripts to: - Track pageviews and custom events via the Events API. - Fetch stats summary, top pages, and realtime visitors. - Requires setting environment variables for site domain and API key. - Outputs data in JSON or plain text format.
Metadata
Slug plausible-analytics-agent
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Plausible Analytics Agent?

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... It is an AI Agent Skill for Claude Code / OpenClaw, with 147 downloads so far.

How do I install Plausible Analytics Agent?

Run "/install plausible-analytics-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Plausible Analytics Agent free?

Yes, Plausible Analytics Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Plausible Analytics Agent support?

Plausible Analytics Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Plausible Analytics Agent?

It is built and maintained by KRYZL19 (@kryzl19); the current version is v1.0.0.

💬 Comments