KosmoKrator

analytics

Plausible Analytics CLI for Cron Jobs

Use the Plausible Analytics CLI for cron jobs with headless JSON commands, schema discovery, credentials, and permission controls.

8 functions 4 read 4 write API key auth

Plausible Analytics CLI for Cron Jobs

Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config.

Use the headless CLI from cron when an operation should run without an interactive agent session. The Plausible Analytics CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Plausible Analytics CLI for Cron Jobs
kosmokrator integrations:configure plausible --set api_key="$PLAUSIBLE_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call plausible.plausible_query_stats '{"site_id":"example_site_id","metrics":"example_metrics","date_range":"example_date_range","dimensions":"example_dimensions","filters":"example_filters","date_from":"example_date_from","date_to":"example_date_to","order_by":"example_order_by"}' --json

Discovery Before Execution

Agents and scripts can inspect Plausible Analytics docs and schemas before choosing a function.

kosmo integrations:docs plausible --json
kosmo integrations:docs plausible.plausible_query_stats --json
kosmo integrations:schema plausible.plausible_query_stats --json
kosmo integrations:search "Plausible Analytics" --json
kosmo integrations:list --json

Useful Plausible Analytics CLI Functions

FunctionTypeParametersDescription
plausible.plausible_query_stats Read site_id, metrics, date_range, dimensions, filters, date_from, date_to, order_by, limit Query website analytics from Plausible. Supports aggregate stats, timeseries, and breakdowns by dimension. Use dimensions to group results (e.g., by country, source, page). Omit dimensions for simple aggregate totals.
plausible.plausible_realtime_visitors Read site_id Get the current number of realtime visitors on a website (visitors in the last 5 minutes).
plausible.plausible_list_sites Read limit, after List websites tracked in Plausible Analytics. Returns site domains you can query for analytics data.
plausible.plausible_create_site Write domain, timezone Register a new website for tracking in Plausible Analytics.
plausible.plausible_delete_site Write site_id Remove a website from Plausible Analytics tracking. This deletes all associated data.
plausible.plausible_list_goals Read site_id List all goals (conversion tracking) configured for a website in Plausible.
plausible.plausible_create_goal Write site_id, event_name, page_path Create a conversion goal for a website in Plausible. Goals can track pageviews to specific pages or custom events.
plausible.plausible_delete_goal Write site_id, goal_id Delete a conversion goal from a website in Plausible.

Automation Notes

Related Plausible Analytics CLI Pages