Fleets

io.github.runFleets由 GitHub 帳號 runFleets 發布v0.2.2更新於 Oct 24, 2026

Multi-site analytics as tools: GA4, Search Console, Cloudflare edge, PageSpeed, insights.

已驗證STDIO僅桌面網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

讓助理取得多個網站的即時分析資料——GA4、Search Console、Cloudflare 邊緣、PageSpeed——並以自然語言查詢。

可以做什麼
fleets-mcp 伺服器把 Fleets 帳號的分析資料以工具形式提供出來。它會列出網站及其已連接的來源，接著回傳 GA4 摘要與細分資料（來源、廣告活動、推薦、到達頁面、事件、使用者、裝置、客層）、轉換漏斗、Google Search Console 摘要、Cloudflare 邊緣分析，以及 PageSpeed/Core Web Vitals。它另外提供可供 AI 使用的洞察、由伺服器端作答並附引用的自然語言 ask 工具，以及可寫入與讀取的單站變更記錄。
適用情境
當你希望助理不必打開 Fleets 應用程式，就能回答自己網站的流量、SEO、邊緣或效能資料問題時，可以使用它。它適合定期報表、漏斗與廣告活動分析，以及在記錄數字的同時維護變更記錄。
執行需求
以 npm 套件 fleets-mcp 透過 stdio 在本機執行（Node.js >= 22；支援 macOS、Linux、Windows）。驗證使用 Fleets 個人存取權杖：執行一次 fleets login 並存入 ~/.fleets/config.json，或設定 FLEETS_TOKEN 環境變數。需要連線至 Fleets 及所連接分析來源的網路。
安裝前請注意
FLEETS_TOKEN 個人存取權杖屬於憑證，且會覆寫已儲存的設定檔，應視為機密保管，不要提交到版本庫。多數工具為唯讀，但 log_change 會對你的網站寫入一筆變更記錄。ask 工具會把你的問題送到伺服器端作答，分析資料則來自 GA4、Search Console、Cloudflare 等第三方來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Fleets，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

fleets

Terminal CLI for Fleets. Per-site commands mirror the app UI tabs at https://fleets.run/app/<slug>/<tab>.

Install

bash
npm install -g fleets

Authenticate

bash
fleets login

Picks between two methods:

  1. browser (default) — device flow: CLI prints a URL + 8-character code, auto-opens your browser, you click authorize, CLI finishes automatically.
  2. paste a token — mint one in app → account → cli, paste it in.

Skip the prompt with a flag:

bash
fleets login --browser     # force device flowfleets login --paste       # force token paste
fleets login --token fl_xxxxxxxxxxxxxxxx   # paste in one shot (CI)export FLEETS_TOKEN=fl_xxxxxxxxxxxxxxxx     # skip login entirely

Slug-first dispatch

The most intuitive way to run commands is to put the site slug first, like you're "inside" that site:

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

The legacy form fleets <command> <slug> (e.g. fleets sources fightbets) still works.

Commands

Setup

CommandDescription
fleets loginBrowser device-flow auth (no paste)
fleets add <domain> [--detect]Create a site; --detect auto-links GA4 + GSC
fleets connect <slug>Auto-detect GA4 + GSC via service account
fleets connect <slug> --property <id>Set GA4 property explicitly
fleets connect <slug> --gsc <site-url>Set GSC site explicitly

Analytics (per-site)

All accept --range (default 7d) and --json. Commands with top-N tables also accept --limit.

CommandTabData source
fleets list—All your sites with sparkline + Δ7d
fleets <slug> / fleets stats <slug>dayGA4 summary
fleets <slug> sourcessourcesGA4 traffic sources
fleets <slug> campaignscampaignsGA4 UTM campaigns
fleets <slug> referralsreferralsGA4 referrals
fleets <slug> landerslandersGA4 landing pages
fleets <slug> eventseventsGA4 events
fleets <slug> usersusersGA4 country + device breakdown
fleets <slug> funnel <step1> <step2>…funnelGA4 funnel
fleets <slug> seoseoGoogle Search Console
fleets <slug> edgeedgeCloudflare Analytics
fleets <slug> speedspeedPageSpeed Insights

Utility

CommandDescription
fleets <slug> exportDaily GA4 CSV/JSON export
fleets <slug> query "<text>"Natural-language analytics query
fleets <slug> open [tab]Print the app URL for a site

MCP server

The same package ships an MCP server, fleets-mcp, so agents (Claude Code, Claude Desktop, Cursor, …) can pull your live Fleets analytics as tools. It reuses the CLI's auth — run fleets login once (or set FLEETS_TOKEN) and the MCP server picks up the same token from ~/.fleets/config.json.

Add it to a client

Claude Code:

bash
claude mcp add fleets -- fleets-mcp

Claude Desktop / Cursor (claude_desktop_config.json or .cursor/mcp.json):

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

No global install? Use npx with the fleets-mcp launcher package:

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

If you authenticate via env instead of fleets login, add "env": { "FLEETS_TOKEN": "fl_xxx" } to the server entry.

Tools

All read-only except log_change (writes a change-log entry). Every analytics tool takes a slug (from list_sites) and an optional range (7d, 30d, 24h).

ToolWhat it returns
list_sitesAll sites + connected sources (GA4 / Cloudflare / GSC) — start here
statsGA4 summary: sessions, users, pageviews, events, engagement, bounce
sources · campaigns · referrals · landers · eventsGA4 breakdowns (accept limit)
users · devices · demographicsGA4 audience breakdowns
funnelGA4 conversion funnel across steps (2+)
seoGoogle Search Console summary
edgeCloudflare edge analytics (bots, humans, cache)
speedPageSpeed Insights + Core Web Vitals
insightsAI-ready signals worth investigating (optionally per site)
askNatural-language question answered server-side with citations
log_change · recallWrite / read the per-site change log

Environment variables

VariableDescription
FLEETS_TOKENPersonal access token. Skip fleets login entirely — useful for CI. Overrides ~/.fleets/config.json.

Range format

All --range flags accept:

  • 7d — last 7 days
  • 30d — last 30 days
  • 90d — last 90 days
  • 24h — last 24 hours (rounds to 1 day)

Requirements

  • Node.js >= 22 (LTS)
  • Works on macOS, Linux, Windows

來源：README.md，提交 ba6d038

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分