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شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.