名称： supalytics
描述： 使用 Supalytics CLI 查询网站分析数据。当用户需要查看页面浏览量、访客数、热门页面、流量来源、引荐来源、国家/地区、收入指标、转化、漏斗、事件或实时访客时使用。
元数据： {"openclaw":{"emoji":"📊","requires":{"bins":["supalytics"]},"homepage":"https://supalytics.co"}}

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

认证

重要提示：在代理环境中的 OAuth

supalytics login 命令使用 OAuth 设备流程，需要在浏览器中进行用户交互。在代理环境（如 OpenClaw 等）中，该过程可能在 OAuth 完成前被终止。

OpenClaw 解决方案： 使用 background: true 模式：

await exec({
  command: 'supalytics login',
  background: true,
  yieldMs: 2000  // 等待 2 秒以捕获验证 URL
});

代理应执行以下操作：
1. 在后台模式下运行登录命令
2. 提取并向用户展示验证 URL
3. 等待用户在浏览器中完成授权
4. 轮询后台会话以检查是否完成

快速设置

supalytics init    # 打开浏览器，创建站点，显示跟踪代码片段

手动设置

supalytics login        # 打开浏览器进行 OAuth 认证
supalytics sites add    # 创建新站点

命令

快速统计

supalytics stats              # 最近 30 天（默认）
supalytics stats today        # 仅今天
supalytics stats yesterday    # 昨天
supalytics stats week         # 本周
supalytics stats month        # 本月
supalytics stats 7d           # 最近 7 天
supalytics stats --all        # 包含细分数据（页面、引荐来源、国家/地区等）

实时访客

supalytics realtime           # 站点当前访客
supalytics realtime --watch   # 每 30 秒自动刷新

趋势（时间序列）

supalytics trend              # 每日访客趋势（带条形图）
supalytics trend --period 7d  # 最近 7 天
supalytics trend --compact    # 仅显示迷你图

细分数据

supalytics pages              # 按访客数排名的热门页面
supalytics referrers          # 主要引荐来源
supalytics countries          # 按国家/地区划分的流量

事件

supalytics events                          # 列出所有自定义事件
supalytics events signup                   # 特定事件的属性
supalytics events signup --property plan   # 按属性值细分

自定义查询

query 命令最为灵活：

# 带收入的热门页面
supalytics query -d page -m visitors,revenue

# 按国家/地区和设备划分的流量
supalytics query -d country,device -m visitors

# 仅来自美国的博客流量
supalytics query -d page -f "page:contains:/blog" -f "country:is:US"

# 按小时细分
supalytics query -d hour -m visitors -p 7d

# UTM 广告系列效果
supalytics query -d utm_source,utm_campaign -m visitors,revenue

# 按收入降序排序
supalytics query -d page --sort revenue:desc

# 已注册用户访问的页面
supalytics query -d page -f "event:is:signup"

# 按事件属性筛选
supalytics query -d country -f "event_property:is:plan:premium"

可用指标： visitors, pageviews, bounce_rate, avg_session_duration, revenue, conversions, conversion_rate

可用维度： page, referrer, country, region, city, browser, os, device, date, hour, event, utm_source, utm_medium, utm_campaign, utm_term, utm_content

站点管理

supalytics sites                              # 列出所有站点
supalytics sites add example.com              # 创建站点
supalytics sites update my-site -d example.com  # 更新域名
supalytics default example.com                # 设置默认站点
supalytics remove example.com                 # 删除站点

全局选项

所有分析命令均支持：

筛选器语法

格式：字段:操作符:值

操作符： is, is_not, contains, not_contains, starts_with

示例：

-f "country:is:US"
-f "page:contains:/blog"
-f "device:is:mobile"
-f "referrer:is:twitter.com"
-f "utm_source:is:newsletter"
-f "event:is:signup"
-f "event_property:is:plan:premium"

输出格式

人类可读（默认）： 带颜色的格式化表格

JSON (--json): 原始 JSON，用于解析——当需要以编程方式处理数据时使用此选项：

supalytics stats --json | jq '.data[0].metrics.visitors'
supalytics query -d page -m visitors --json

按用例示例

“我的网站表现如何？”

supalytics stats

“我的主要流量来源是什么？”

supalytics referrers
# 或包含收入
supalytics query -d referrer -m visitors,revenue

“哪些页面产生的收入最多？”

supalytics query -d page -m revenue --sort revenue:desc

“我的新闻通讯广告系列效果如何？”

supalytics query -d utm_campaign -f "utm_source:is:newsletter" -m visitors,conversions,revenue

“现在谁在我的网站上？”

supalytics realtime

“显示本周的访客趋势”

supalytics trend --period 7d

故障排除

OpenClaw / 守护进程使用

Bun 安装到 ~/.bun/bin，该路径对于像 OpenClaw 这样的守护进程不在 PATH 中。安装后，请创建到系统路径的符号链接：

sudo ln -sf ~/.bun/bin/bun /usr/local/bin/bun
sudo ln -sf ~/.bun/bin/supalytics /usr/local/bin/supalytics