（6369期）Umami Stats – 隐私优先的网站分析数据查询助手

隐私优先的网站分析数据查询助手 通过官方API安全读取Umami网站分析数据，支持流量统计、页面分析、事件追踪等多维度查询，适用于数据驱动决策与运营监控。 使用说明 核心用法 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) 显著优点 零配置即用：通过环境变量管理认证，脚本自动处理路径映射和认证头 查询辅助完善：自动补全type参数、自动注入websiteId到reports端点 可复现性强：显式时间窗口支持，便于实验对比和数据审计 只读安全：设计上强制GET请求，降低误操作风险 潜在局限 依赖用户配置的API密钥权限，部分端点(/v1/users/*)可能返回403 需自行处理返回JSON的后续分析与可视化 自托管版本需手动指定base-url 适合人群网站运营者、产品经理、数据分析师、需要快速获取流量数据支撑决策的技术团队。 常规风险 API密钥泄露风险（应配置为环境变量，避免硬编码） 数据隐私合规：访问的 analytics 数据可能包含用户行为信息，需确保符合GDPR等法规 速率限制：高频查询可能触发Umami Cloud的API限流 原始说明 Query Umami Cloud (v2) analytics data via API using an environment-provided API key. Use when agents need website traffic, pages, events, sessions, realtime, reports, or attribution data for analysis, planning, experiments, or monitoring. Includes read-only API querying patterns, endpoint selection guidance, and reusable scripts for flexible endpoint + time-range requests.