Supalytics - Web Analytics

核心用法

Supalytics CLI 是一款面向开发者的终端优先网站分析工具，专为追求隐私合规（GDPR友好）和快速数据查询的技术团队设计。核心工作流围绕 supalytics query 展开，支持类SQL的维度-指标组合查询，可实时获取页面浏览量、独立访客、跳出率、平均会话时长、收入、转化等关键指标。安装依赖Bun运行时（非Node.js），通过OAuth设备流完成身份验证后，即可对绑定的站点执行多维度分析。

显著优点

1. 隐私优先架构：原生GDPR合规，无需Cookie横幅，规避了Google Analytics的隐私争议
2. 收入归因能力：内置revenue、conversions、conversion_rate指标，支持电商场景的全链路追踪
3. 终端原生体验：秒级响应的CLI交互，支持趋势图表（sparkline）、实时访客监控（--watch自动刷新）
4. 查询灵活性：15+维度（UTM参数、事件属性、地理位置、设备类型）与8+指标自由组合，支持多过滤条件和排序
5. OpenClaw适配：提供background: true模式解决OAuth在Agent环境中的交互限制

潜在缺点与局限

• 运行时依赖：强制要求Bun而非Node.js，增加环境配置成本
• OAuth流程门槛：登录需浏览器交互，自动化场景需额外处理设备流
• 生态成熟度：作为新兴工具，第三方集成、可视化看板、API稳定性可能不及Plausible/Posthog等竞品
• 数据所有权疑虑：SaaS模式，长期数据留存策略需验证

适合人群

• 技术团队主导的SaaS/电商站点运营者
• 厌倦Google Analytics复杂配置与隐私风险的独立开发者
• 需要将分析能力集成到CI/CD或内部Dashboard的工程师
• 注重终端效率、偏好命令行工作流的数据分析师

常规风险

1. 认证会话管理：OAuth token可能过期，需监控Unauthorized错误并设计重登录逻辑
2. 路径隔离问题：Bun全局安装路径（~/.bun/bin）默认不在daemon进程PATH中，需显式symlink
3. 查询性能边界：复杂多维度聚合在大数据量下可能超时，建议分片查询
4. 测试/生产数据混淆：-t标志控制测试模式，误用可能导致决策偏差

核心用法

Supalytics CLI 是一款面向网站运营者的命令行分析工具，通过简洁的指令快速获取页面浏览量、访客来源、转化漏斗、营收归因等核心指标。使用时需先安装 Bun 运行时（非 Node.js），然后通过 bun add -g @supalytics/cli 全局安装。

身份验证采用 OAuth 设备流，支持 supalytics login 登录后创建站点。核心指令包括：

• 快速统计：supalytics stats [today|yesterday|week|7d] 查看基础流量
• 实时监控：supalytics realtime --watch 追踪当前在线访客
• 趋势分析：supalytics trend --period 7d 生成带柱状图的时间序列
• 灵活查询：supalytics query 支持多维度（页面/国家/设备/UTM 等）与多指标（访客/营收/转化率等）交叉分析

显著优点

1. 隐私优先设计：原生 GDPR 合规，无需 Cookie 同意弹窗，规避欧盟监管风险
2. 营收归因能力：少有的 CLI 工具支持 revenue、conversion_rate 等电商指标，适合独立开发者追踪 ROI
3. 查询语法灵活：-d 多维度组合、-f 字段过滤、--sort 排序，功能接近轻量级 SQL
4. 实时性：realtime 指令提供秒级在线访客数据，优于多数延迟 15-30 分钟的竞品

潜在局限

• 生态依赖单一：强制绑定 Bun 运行时，Node.js 用户需额外安装环境，增加运维成本
• OAuth 交互复杂：设备流授权在自动化/Agent 场景中需特殊处理（background 模式 + 用户手动确认），难以实现完全无人值守
• 可视化受限：CLI 输出以表格和 ASCII 图表为主，复杂分析需导出 JSON 自行处理
• 来源可信度：维护者为个人开发者（yogesharc），非企业级背书，长期维护稳定性存疑

适合人群

• 重视隐私合规的欧盟市场网站运营者
• 技术背景较强的独立开发者、SaaS 创始人
• 需要快速 CLI 查询、反感重仪表板（heavy dashboard）的极简主义用户
• 具备 Bun/Node 环境管理能力的 DevOps 工程师

常规风险

| 风险类别 | 说明 |

|---------|------|

| 供应链风险 | `curl \| bash` 安装 Bun 属于单层远程拉取，需信任 bun.sh 域名安全 |

| 凭证管理 | OAuth token 存储于本地，多用户服务器场景需防范权限泄露 |

| 数据边界 | 分析数据上传至 Supalytics 云服务，敏感业务需评估第三方托管合规性 |

| 单点故障 | 服务可用性依赖 supalytics.co，无自托管选项 |

建议生产环境配合定期 JSON 备份（--json 导出），并监控官方服务状态页面。