Fleets

fleets

Fleets のターミナル CLI です。サイトごとのコマンドは、https://fleets.run/app/<slug>/<tab> にあるアプリのタブに対応しています。

インストール

npm install -g fleets

認証

fleets login

次の 2 つの方法から選択できます。

1. browser（デフォルト） — デバイスフローです。CLI が URL と 8 文字のコードを表示し、ブラウザーを自動で開きます。authorize をクリックすると、CLI が自動で処理を完了します。
2. paste a token — アプリ → アカウント → 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

スラッグ優先のディスパッチ

最も直感的なコマンドの実行方法は、サイトの「内部」にいるように、サイトのスラッグを先頭に置くことです。

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 を使用できます。上位 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 Analytics
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 も含まれており、MCP に対応しています。 これにより、エージェント（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 を除き、すべて読み取り専用です（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 向けシグナル（任意でサイトごとに指定可能）
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 で動作します