SuperAPI AI 工具集

analyticscli-cli

数据与分析

查看项目

更新于 10-16 07:18

技能介绍

用途:该技能用于通过 AnalyticsCLI 命令行工具查询产品分析数据、验证 SDK 埋点是否正确落地,以及提交和查看关于 AnalyticsCLI 本身的产品反馈,覆盖漏斗、付费墙、留存、问卷、导出等问题,无需写原始 SQL。

主要能力:优先提供 funnel、conversion-after、paths-after、retention、survey、timeseries、breakdown、generic 等高层查询命令族;仅在用户明确需要原始 CSV 时才使用 events export。支持 analyticscli schema events、goal-completion、get 等只读校验,反馈相关命令包括 feedback list、feedback summary、feedback submit。输出可用 --format json 供自动化使用,--format text 作简要人类摘要,timeseries 支持 --viz table/chart/svg。

使用方式:安装 npm 包 @analyticscli/cli(二进制名为 analyticscli),例如 npm install -g @analyticscli/cli;VPS 上全局安装受限时可用 npm install -g --prefix "$HOME/.local" @analyticscli/cli 并设置 PATH。首次使用需在 dash.analyticscli.com 创建只读 token(scope read:queries),通过交互式提示填入,不要将 token 作为命令参数传递;用 analyticscli projects select 设置默认项目,也可用 --project <id> 指定。查询必须限定时间(--last 或 since/until)并保持分组与结果集有界。如提示 analyticscli: command not found,应安装或更新该 npm 包。

适用场景:产品分析查询、SDK 埋点校验、漏斗与留存分析、付费墙与问卷问题、导出、以及向 AnalyticsCLI 反馈缺失能力或故障。

限制与规则:不生成原始 SQL,不请求无界原始事件转储,除非用户明确要求否则不包含调试数据;不要将密钥通过命令行参数传递;CLI 与仪表盘均查询同一 API,无 CLI 独有数据源;序列敏感与群组敏感查询须走原始事件。版本支持范围为 @analyticscli/cli >=0.1.3 <0.2.0,技能包版本 1.0.7。若功能缺失,应如实说明并提交反馈,不要用不等价的命令冒充。