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-statsCLIコマンドを実行するか、Claude Code、Cursor、Codexなどお使いのコーディングエージェントにプロンプトを貼り付けてください。