Fleets

fleets

Fleets 的终端 CLI。每个站点的命令对应 https://fleets.run/app/<slug>/<tab> 中的应用界面标签页。

安装

npm install -g fleets

身份验证

fleets login

可在两种方式中选择：

1. browser（默认） — 设备授权流程：CLI 会打印一个 URL 和 8 位代码，自动打开浏览器；点击 authorize 后，CLI 会自动完成验证。
2. paste a token — 在应用中 → account → cli 创建令牌，然后粘贴到此处。

使用标志跳过提示：

fleets login --browser     # force device flow
fleets login --paste       # force token paste

fleets login --token fl_xxxxxxxxxxxxxxxx   # paste in one shot (CI)
export FLEETS_TOKEN=fl_xxxxxxxxxxxxxxxx     # skip login entirely

优先使用 slug 分派命令

最直观的命令运行方式是将站点 slug 放在最前面，就像你“进入”了该站点一样：

fleets fightbets                         # GA4 summary (defaults to stats)
fleets fightbets sources                 # top traffic sources
fleets fightbets funnel session_start view   # conversion funnel
fleets fightbets seo --range 30d         # GSC summary, last 30 days
fleets fightbets open settings           # print app URL

旧格式 fleets <command> <slug>（例如 fleets sources fightbets）仍可使用。

命令

设置

命令	描述
fleets login	浏览器设备授权流程（无需粘贴）
fleets add <domain> [--detect]	创建站点；--detect 会自动关联 GA4 和 GSC
fleets connect <slug>	通过服务账号自动检测 GA4 和 GSC
fleets connect <slug> --property <id>	显式设置 GA4 属性
fleets connect <slug> --gsc <site-url>	显式设置 GSC 站点

分析（按站点）

所有命令都接受 --range（默认为 7d）和 --json。带有 Top N 表格的命令还接受 --limit。

命令	标签页	数据来源
fleets list	—	所有站点，附带迷你趋势图和 Δ7d
fleets <slug> / fleets stats <slug>	day	GA4 概览
fleets <slug> sources	sources	GA4 流量来源
fleets <slug> campaigns	campaigns	GA4 UTM 广告系列
fleets <slug> referrals	referrals	GA4 引荐来源
fleets <slug> landers	landers	GA4 着陆页
fleets <slug> events	events	GA4 事件
fleets <slug> users	users	GA4 国家和设备细分
fleets <slug> funnel <step1> <step2>…	funnel	GA4 漏斗
fleets <slug> seo	seo	Google Search Console
fleets <slug> edge	edge	Cloudflare 分析
fleets <slug> speed	speed	PageSpeed Insights

实用工具

命令	描述
fleets <slug> export	导出每日 GA4 CSV/JSON 数据
fleets <slug> query "<text>"	自然语言分析查询
fleets <slug> open [tab]	打印站点的应用 URL

MCP 服务

同一个包还提供了 MCP 服务 fleets-mcp， 让 Agent（Claude Code、Claude Desktop、Cursor 等）能够将 Fleets 的实时分析数据用作工具。它沿用 CLI 的身份验证方式——运行一次 fleets login（或设置 FLEETS_TOKEN），MCP 服务便会从 ~/.fleets/config.json 中读取同一个令牌。

添加到客户端

Claude Code：

claude mcp add fleets -- fleets-mcp

Claude Desktop / Cursor（claude_desktop_config.json 或 .cursor/mcp.json）：

{
  "mcpServers": {
    "fleets": {
      "command": "fleets-mcp"
    }
  }
}

尚未全局安装？使用 fleets-mcp 启动程序包，通过 npx 运行：

{
  "mcpServers": {
    "fleets": {
      "command": "npx",
      "args": ["-y", "fleets-mcp"]
    }
  }
}

如果使用环境变量而非 fleets login 进行身份验证，请在服务条目中添加 "env": { "FLEETS_TOKEN": "fl_xxx" }。

工具

除 log_change（会写入一条变更日志记录）外，所有工具均为只读。每个分析 工具都需要一个 slug（通过 list_sites 获取），并可选地接受 range（7d、30d、24h）。

工具	返回内容
list_sites	所有站点及其已连接的数据源（GA4 / Cloudflare / GSC）——从这里开始
stats	GA4 概览：会话数、用户数、页面浏览量、事件数、互动度、跳出率
sources · campaigns · referrals · landers · events	GA4 细分数据（接受 limit）
users · devices · demographics	GA4 受众细分数据
funnel	跨 steps（至少 2 个步骤）的 GA4 转化漏斗
seo	Google Search Console 概览
edge	Cloudflare 边缘分析（机器人、真人、缓存）
speed	PageSpeed Insights 和 Core Web Vitals
insights	值得调查的 AI 就绪信号（可按 site 查询）
ask	在服务端回答自然语言问题，并附上引文
log_change · recall	写入 / 读取按站点记录的变更日志

环境变量

变量	描述
FLEETS_TOKEN	个人访问令牌。完全跳过 fleets login，适用于 CI。优先级高于 ~/.fleets/config.json。

时间范围格式

所有 --range 标志均接受：

• 7d — 最近 7 天
• 30d — 最近 30 天
• 90d — 最近 90 天
• 24h — 最近 24 小时（按 1 天取整）

要求

• Node.js >= 22（LTS）
• 支持 macOS、Linux、Windows