核心用法
Umami Stats是一个只读数据访问层技能，用于通过Umami Cloud v2 API获取网站分析数据。核心工作流为：选择端点 → 执行查询 → 分析JSON返回。
关键能力
- 多场景数据查询：网站统计(stats)、页面浏览(pageviews)、事件(events)、会话(sessions)、实时(realtime)数据、归因(reports)等
- 灵活时间窗口：内置预设(today/last7d/last30d等)或自定义时间戳
- 双模式兼容：自动适配Cloud模式(
/v1+x-umami-api-key)和自托管模式(/api+Authorization: Bearer)
显著优点
1. 零配置即用：通过环境变量管理认证，脚本自动处理路径映射和认证头
2. 查询辅助完善：自动补全type参数、自动注入websiteId到reports端点
3. 可复现性强：显式时间窗口支持，便于实验对比和数据审计
4. 只读安全：设计上强制GET请求，降低误操作风险
潜在局限
- 依赖用户配置的API密钥权限，部分端点(
/v1/users/*)可能返回403 - 需自行处理返回JSON的后续分析与可视化
- 自托管版本需手动指定
base-url
适合人群
网站运营者、产品经理、数据分析师、需要快速获取流量数据支撑决策的技术团队。
常规风险
- API密钥泄露风险（应配置为环境变量，避免硬编码）
- 数据隐私合规：访问的 analytics 数据可能包含用户行为信息，需确保符合GDPR等法规
- 速率限制：高频查询可能触发Umami Cloud的API限流