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 등 사용하는 코딩 에이전트에 붙여넣으세요.