关于 umami
umami 是用于从 Umami 实例获取流量摘要和分析数据的技能，面向需要整理网站访问情况的用户。它可汇总当前与上一周期指标，也支持仅查询实时活跃访客。
主要功能
- 01获取网站流量摘要
- 02对比当前与上一周期指标
- 03查询实时活跃访客
- 04将统计结果整理为表格
适用场景
- 01制作每日网站流量报告
- 02查看当前在线访客数量
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/umami确认已加载。
附带文件references/api.mdscripts/umami-summary.sh
详细介绍
Umami 分析
从 Umami 实例获取流量摘要和分析数据。
配置
运行前设置以下环境变量：
| 变量 | 必需性 | 说明 |
|---|---|---|
UMAMI_API_URL | 是 | Umami 实例的基础 URL（例如 https://cloud.umami.is） |
UMAMI_API_KEY | 二选一 | Umami Cloud 的 API 密钥。直接用作 Bearer 令牌。 |
UMAMI_USERNAME | 二选一 | 通过 /api/auth/login 登录可自托管实例时使用的用户名。 |
UMAMI_PASSWORD | 与用户名搭配 | 可自托管实例登录密码。 |
如果设置了 UMAMI_API_KEY，则优先使用它，而非用户名/密码。
工作流：每日流量摘要
- 运行脚本：
bash ~/Projects/skills/umami/scripts/umami-summary.sh - 解析 JSON 输出。
- 格式化为 Markdown 表格：
| 网站 | 域名 | 浏览量 | 访客 | 访问次数 | 跳出次数 | 平均时长 | 活跃人数 |
|---|---|---|---|---|---|---|---|
| 我的博客 | blog.example.com | 1,234 (980) | 567 (510) | 890 (801) | 123 (110) | 45s (38s) | 3 |
| 总计 | 1,234 (980) | 567 (510) | 890 (801) | 123 (110) | 45s (38s) | 3 |
- 在每项指标后面的括号中显示上一时段的数值（例如，“1,234 (980)”表示当前为 1,234，上一时段为 980）。
- 为数字添加千位分隔符，便于阅读。
- 将
totaltime转换为易读的时长（例如“1m 23s”）。 - 对每个网站，使用
totaltime / visits计算平均时长；上一时段则使用prev_totaltime / prev_visits计算。 - 将总计行加粗。
工作流：仅查看活跃用户
对于“现在谁在访问我的网站？”之类的查询，请使用轻量级标志：
bash ~/Projects/skills/umami/scripts/umami-summary.sh --active-only
此选项会跳过统计 API 调用，只获取当前活跃访客数。格式化为更简洁的表格：
| 网站 | 域名 | 活跃人数 |
|---|---|---|
| 我的博客 | blog.example.com | 3 |
错误处理
脚本会以非零状态码退出，并在 stderr 中写入 JSON 错误信息：
- 缺少环境变量：
{"error": "UMAMI_API_URL is not set"} - 认证失败：
{"error": "Authentication failed (HTTP 401)"} - 无法连接服务器：
{"error": "Could not connect to https://..."}
请向用户清楚说明这些错误及具体信息，并建议检查环境变量。
API 参考
如需查询每日摘要以外的数据（时间序列、指标细分、自定义日期范围），请参阅 references/api.md。
评论
支持 Markdown