Supalytics分析查询

技能简介

Supalytics CLI 是一款用于查询网站分析数据的命令行工具，对接 Supalytics 分析平台。

业务背景

市场与运营团队无需登录复杂后台，通过命令行即可秒级获取网站核心数据。支持实时监控流量波动、快速定位转化瓶颈，帮助决策者及时响应市场变化，提升数据驱动效率。

落地案例：电商大促期间，运营人员运行 `supalytics realtime` 监控实时访客数，发现某渠道流量骤降后立即调整投放策略；次日通过 `supalytics trends –days 7 –metric revenue` 查看收入趋势图，结合设备维度拆解，确认移动端支付环节流失严重，优先推动技术优化。

能做什么

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

使用说明

环境要求：必须使用 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 仓库