umami-stats
от hfichter
Web & Frontend DevelopmentКратко
Query Umami Cloud (v2) analytics data via API using an environment-provided API key.
Описание
Что делает этот навык
Provides read-only access to Umami analytics data via the Umami Cloud v2 API or a self-hosted Umami instance. A Python script handles endpoint selection, authentication, and time-range presets so agents can fetch traffic, page, event, session, and report data without manual API setup.
The included query script abstracts auth differences between cloud and self-hosted Umami and handles path mapping automatically, so agents can fetch data with a single command instead of constructing raw API calls.
Когда его использовать
- Checking weekly website traffic trends
- Finding top-performing pages over the last 30 days
- Monitoring signup click events over a custom date range
- Pulling raw analytics data to plan a marketing experiment
- Comparing current week vs previous week session counts
Пример сценария
User asks: What were my top pages in the last 30 days?
- 1
Identify the website ID from UMAMI_WEBSITE_ID env var or by calling /v1/websites
- 2
Run umami_query.py with --endpoint /v1/websites/{websiteId}/pageviews and --preset last30d
- 3
Receive JSON response containing page URLs and view counts
- 4
Sort and extract the top entries from the returned data
A ranked list of pages with their view counts for the past 30 days
Требования
- UMAMI_API_KEY environment variable
- Umami Cloud account or self-hosted Umami instance
- UMAMI_WEBSITE_ID environment variable (if not passing --website-id at runtime)
Установка
clawhub install hfichter/umami-statsВыполните команду CLI или вставьте промпт в Claude Code, Cursor, Codex — любой кодинг-агент, которым пользуетесь.