supalytics

Supalytics CLI 技能是一个专为网站数据分析设计的工具集成方案，允许用户通过命令行界面快速查询 Supalytics 平台托管的网站流量数据。该技能基于 Bun 运行时环境构建，提供从基础统计到高级自定义查询的全套分析能力，特别适合需要实时洞察网站表现的技术团队和数据驱动型运营人员使用。

核心用法围绕 supalytics CLI 工具展开，用户首先需要通过 Bun 包管理器全局安装 @supalytics/cli，随后使用 OAuth 设备流完成身份验证。技能支持多种查询模式：快速统计（stats）可查看指定周期的页面浏览量和访客数；实时监控（realtime）展示当前在线用户；趋势分析（trend）生成带柱状图的时间序列数据；而强大的 query 命令则支持多维度（页面、国家、设备、UTM 来源等）和自定义指标（访客数、收入、转化率等）的组合查询，并可通过过滤语法精准定位特定数据子集。

显著优点包括其 GDPR 合规的隐私保护设计，消除了对欧盟用户数据的合规担忧。收入归因功能允许将财务指标与流量来源直接关联，这对电商和 SaaS 企业尤为重要。命令行界面支持 JSON 原始输出，便于与 OpenClaw 等自动化工作流集成。灵活的过滤语法（支持 contains、starts_with 等操作符）和实时数据刷新能力（--watch 模式）进一步提升了数据探索效率。

潜在局限性主要体现在技术栈依赖上：该工具强制要求 Bun 运行时而非主流的 Node.js，这可能增加环境配置复杂度。OAuth 认证流程在自动化代理环境中需要特殊的后台模式处理（background: true），增加了集成门槛。此外，数据来源仅限于 Supalytics 平台本身，无法直接对接 Google Analytics 等其他分析服务，且作为 T3 级社区来源工具，其长期维护稳定性有待观察。

该技能适合网站管理员、增长黑客、数据分析师以及需要将分析能力集成到 CLI 工作流的技术团队。特别适用于关注隐私合规的欧洲市场运营者，以及需要实时收入数据追踪的电商开发者。

使用风险主要包括：安装阶段需执行 Bun 安装脚本和 npm 包下载，存在供应链攻击的潜在风险；OAuth 凭据管理不当可能导致分析数据泄露；对 Supalytics 云服务的网络依赖意味着在隔离环境或网络不稳定场景下无法使用。建议用户在可信网络环境下安装，并定期审查 CLI 工具的权限范围。