Supalytics分析查询

技能简介

Supalytics CLI 是一款用于查询网站分析数据的命令行工具，对接 Supalytics 分析平台。支持查看页面浏览量、访客数、流量来源、转化漏斗、收入指标及实时访客等数据，采用 GDPR 合规设计并内置收入归因功能。

能做什么

• 快速获取站点统计数据（今日、昨日、本周、本月或自定义时段）
• 查看实时在线访客并自动刷新监控
• 分析访客趋势时间序列，输出条形图或迷你图
• 按页面、来源、国家、设备等维度拆解流量
• 追踪自定义事件及其属性分布
• 执行灵活的多维查询，支持过滤、排序和收入关联
• 管理多站点配置与默认站点设置

使用说明

环境要求：必须使用 Bun 运行时（不支持 Node.js）。

安装步骤：

# 安装 Bun
curl -fsSL https://bun.sh/install | bash
export PATH="$HOME/.bun/bin:$PATH"

# 安装 Supalytics CLI
bun add -g @supalytics/cli

初始化与认证：

# 快速初始化（浏览器交互创建站点）
supalytics init

# 或手动登录（OAuth 设备流）
supalytics login
supalytics sites add example.com

常用查询示例：

# 基础统计
supalytics stats --all

# 实时监控
supalytics realtime --watch

# 趋势分析
supalytics trend --period 7d

# 灵活查询：美国博客流量，按页面和收入排序
supalytics query -d page -m visitors,revenue -f "page:contains:/blog" -f "country:is:US" --sort revenue:desc

输入与输出

见下方输入与输出表格。

风险提示

• OAuth 登录流程需要浏览器交互，在自动化代理环境中可能被中断，建议使用 background 模式并人工完成授权
• 依赖 Bun 运行时，Node.js 环境无法直接运行
• 收入相关指标仅在配置收入追踪后可用
• 过滤器语法需严格遵循 field:operator:value 格式，运算符仅支持 is/is_not/contains/not_contains/starts_with

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/yogesharc/supalytics/SKILL.md
来源类型：GitHub 仓库