GTmetrix MCP

官方

官方 GTmetrix MCP：從你的 AI 工具執行真實網頁效能測試、讀取報告、追蹤歷史記錄並管理監控。提供訪客存取；完整功能需使用 OAuth 或 API 金鑰。

造訪 gtmetrix.com

你可以用 GTmetrix MCP 做什麼？

  • 執行效能測試 — 請助理從指定地點、使用指定瀏覽器、裝置和節流預設值測試 URL，然後回傳報告。
  • 分析報告 — 查看 GTmetrix 評級、Core Web Vitals 和 Lighthouse 主要問題，並取得 HAR 和 Lighthouse JSON 下載連結。
  • 追蹤歷史記錄與退步情況 — 列出頁面及其最新分數，並擷取某個頁面的所有報告，以比較一段時間內的趨勢。
  • 管理監控與警示 — 開啟或關閉監控，並設定分數、時間、頁面大小、請求數或 CLS 的警示條件。
  • 使用標籤整理頁面 — 一次為最多 500 個頁面建立、重新命名、附加或刪除標籤。
  • 查看帳戶與目錄 — 查看剩餘點數，並查詢可用的地點、瀏覽器、裝置和節流預設值。

託管 MCP 伺服器

npx add-mcp 'https://gtmetrix.com/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

GTmetrix MCP

官方 GTmetrix MCP 伺服器會將您的 AI 工具連接至 GTmetrix，讓它能透過提示執行實際的頁面效能測試、讀取報告、追蹤歷史記錄及管理監控。

試用不需要 GTmetrix 帳戶。 以訪客身分連線即可立即開始測試。登入即可解鎖更多測試與功能。

  • 伺服器 URL： https://gtmetrix.com/mcp
  • 傳輸方式： Streamable HTTP（遠端，無需安裝）
  • 驗證方式： 訪客（無需登入）、OAuth，或透過 Authorization: Bearer 標頭提供 API 金鑰
  • 適用於： Claude、ChatGPT、Codex、Cursor、GitHub Copilot CLI，以及任何相容 MCP 的用戶端

快速入門

選項 1：OAuth（建議）

  1. 在您的 AI 工具中新增遠端 MCP 伺服器／自訂連接器。
  2. 將其命名為 GTmetrix，並將 URL 設為 https://gtmetrix.com/mcp。
  3. 按一下 Connect / Authenticate。

無需 API 金鑰。您也可以從 GTmetrix 帳戶頁面的 MCP Setup 區段複製 MCP URL。

以訪客身分使用

開始使用不需要 GTmetrix 帳戶。以訪客身分，您可以使用有限的訪客點數執行測試、讀取報告，以及查詢地點、瀏覽器和裝置。

訪客點數用完，或想使用與帳戶綁定的功能（頁面歷史記錄、監控、警示、標籤）時，請要求 AI 協助您登入。它會呼叫 gtmetrix_reauthenticate，接著您會看到登入頁面，可在此登入或建立免費帳戶。

選項 2：API 金鑰

在 GTmetrix 帳戶頁面產生 API 金鑰，然後將金鑰新增至用戶端設定。

Claude Code

claude mcp add gtmetrix https://gtmetrix.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY"

Codex (config.toml)

[mcp_servers.gtmetrix]
url = "https://gtmetrix.com/mcp"

[mcp_servers.gtmetrix.http_headers]
Authorization = "Bearer YOUR_API_KEY"

JSON 設定（Cursor 和其他支援遠端 HTTP 伺服器的用戶端）

{
  "mcpServers": {
    "gtmetrix": {
      "url": "https://gtmetrix.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot CLI（僅限 OAuth）

/mcp add GTmetrix

將 Server Type 設為 HTTP、URL 設為 https://gtmetrix.com/mcp、Tools 設為 *，儲存後在瀏覽器中完成驗證。

逐步指南：Claude · ChatGPT · Codex · Cursor · Copilot CLI

提示範例

  • 「從倫敦和雪梨使用 iPhone LTE 測試 example.com，並告訴我效能是否相近。」
  • 「分析 example.com 的最新報告，並用淺顯的方式說明最重要的 3 個問題。」
  • 「檢查所有標記為 'client' 的受監控頁面。標示任何評級低於 B，或 LCP 超過 2 秒的頁面。」
  • 「比較我結帳頁面本週與上個月的報告。有任何退步嗎？」
  • 「為我的首頁設定每日監控，並在 LCP 超過 2.5 秒時通知我。」
  • 「修正網站上阻礙呈現的 JavaScript，然後重新執行 GTmetrix 並確認是否有所改善。」

工具

訪客可以使用測試工具（gtmetrix_get_report_har 除外），以及帳戶和參考工具。其餘工具需要 GTmetrix 帳戶。

測試

工具功能
gtmetrix_start_test對 URL 啟動測試。支援地點、瀏覽器、模擬裝置、連線限速、AdBlock、影片、Cookie、HTTP 驗證、URL 允許／封鎖清單、檢視區大小，以及報告保留期限（1、6、12 或 24 個月）。
gtmetrix_get_test檢查執行中的測試。伺服器端長輪詢（每次呼叫最多 30 秒），並在測試完成時傳回報告 ID。
gtmetrix_get_report取得已完成的報告：GTmetrix 評級、Performance 和 Structure 分數、Core Web Vitals（LCP、TBT、CLS）、依影響程度排序的前 5 項 Lighthouse 問題、資源摘要，以及 HAR 和完整 Lighthouse JSON 的下載連結。
gtmetrix_get_report_har直接內嵌傳回 HAR 瀑布圖，適用於無法直接下載 HAR URL 的用戶端。預設有大小限制。

歷史記錄和頁面

工具功能
gtmetrix_list_pages列出您的頁面（URL + 測試設定），並顯示最新分數、Web Vitals、監控狀態和標籤。可依 URL、地點、瀏覽器、裝置、限速、監控頻率、標籤等條件篩選。
gtmetrix_get_report_history依時間由新到舊取得某個頁面的所有報告，用於趨勢和退步分析。

監控和警示

工具功能
gtmetrix_set_page_monitoring開啟（每小時、每日、每週、每月）或關閉頁面的監控。
gtmetrix_get_page_alert_conditions讀取頁面的警示條件。
gtmetrix_set_page_alert_conditions設定分數、時間（LCP、TTFB、TBT 等）、頁面大小、請求數或 CLS 的警示條件。
gtmetrix_get_page_alert_events列出頁面觸發的警示，並附上相關報告的連結。

標籤

工具功能
gtmetrix_list_page_tags列出您的標籤，以及使用各標籤的頁面數量。
gtmetrix_save_page_tag建立標籤，或重新命名／變更現有標籤的顏色。
gtmetrix_update_page_tags一次為最多 500 個頁面新增或移除標籤。
gtmetrix_delete_page_tag永久刪除標籤。

帳戶和參考

工具功能
gtmetrix_get_account_status顯示您的方案、剩餘 API 點數和下次補充日期（訪客會看到剩餘訪客點數）。
gtmetrix_get_catalog查詢可用的瀏覽器、地點、模擬裝置、限速預設值和 Lighthouse 稽核項目。
gtmetrix_get_guide閱讀內建指南，了解測試選項、報告分析、HAR 分析和測試錯誤。
gtmetrix_reauthenticate從訪客連線登入，或切換至其他 GTmetrix 帳戶。

資源

伺服器也會將指南和目錄公開為 MCP 資源：

  • gtmetrix://docs/test-options-guide
  • gtmetrix://docs/report-analysis-guide
  • gtmetrix://docs/har-analysis-guide
  • gtmetrix://docs/general-test-error-guide
  • gtmetrix://docs/lighthouse-error-guide
  • gtmetrix://catalog/browsers
  • gtmetrix://catalog/locations
  • gtmetrix://catalog/simulated-devices
  • gtmetrix://catalog/throttle-connections
  • gtmetrix://catalog/lighthouse-audits

點數和限制

  • 任何人都可以使用 MCP。訪客可獲得有限點數；GTmetrix 帳戶則可取得更多點數。
  • 測試和其他操作使用 API 點數的費率與 GTmetrix API 相同。每次測試錄製影片會額外使用 0.9 點。
  • 點數額度取決於您的方案。部分 PRO 方案每日補充點數。請要求 AI 執行 gtmetrix_get_account_status 查看餘額。
  • 同時執行的測試數量：Basic 為 2 個，PRO 為 8 個。
  • 部分功能（更多地點、每小時監控、警示中的影片）取決於您的方案。

查看 GTmetrix PRO 方案

常見問題

這是聊天機器人嗎？ 不是。它是連線層，可讓您正在使用的 AI 工具存取 GTmetrix。

我需要 GTmetrix 帳戶嗎？ 不需要。您可以以訪客身分連線並立即執行測試。登入即可解鎖更多測試與功能。

我需要 API 金鑰嗎？ 只有手動設定時才需要。OAuth 連線不需要 API 金鑰。

為什麼結果沒有以圖表呈現？ 圖表呈現方式取決於您的 AI 工具。取得報告後，請要求它「將這些資料視覺化」。

它能幫我修正問題嗎？ GTmetrix 會提供資料和診斷資訊。如果您的 AI 工具也能編輯程式碼或 CMS，就可以套用修正並重新執行測試，以確認結果。

連結