Bỏ qua tới nội dung
TakoAPI
Quay lại kỹ năng

umami-stats

bởi hfichter

Web & Frontend Development
872Lượt tải do clawskills.sh công bố
1Lượt xem
0 lượt thíchĐăng nhập để thích kỹ năng này
—Chưa có đánh giá
Đánh giá của bạn

Tóm tắt

Query Umami Cloud (v2) analytics data via API using an environment-provided API key.

Mô tả

Kỹ năng này làm gì

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.

Khi nào nên dùng

  • 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

Quy trình ví dụ

ĐẦU VÀO

User asks: What were my top pages in the last 30 days?

AGENT
  1. 1

    Identify the website ID from UMAMI_WEBSITE_ID env var or by calling /v1/websites

  2. 2

    Run umami_query.py with --endpoint /v1/websites/{websiteId}/pageviews and --preset last30d

  3. 3

    Receive JSON response containing page URLs and view counts

  4. 4

    Sort and extract the top entries from the returned data

ĐẦU RA

A ranked list of pages with their view counts for the past 30 days

Yêu cầu

  • 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)

Cài đặt

clawhub install hfichter/umami-stats

Chạy lệnh CLI, hoặc dán prompt vào Claude Code, Cursor, Codex hay coding agent bạn đang dùng.

Liên kết