/ 目錄 / 演練場 / mcp-google-ads
● 官方 cohnen ⚡ 即開即用

mcp-google-ads

作者 cohnen · cohnen/mcp-google-ads

透過對話介面對您的 Google Ads 帳號執行 GAQL 查詢,支援帳號列表、廣告活動與廣告成效查詢、自訂查詢,並可使用 OAuth 或服務帳號驗證。

mcp-google-ads 是一個與 Google Ads API 溝通的 Python MCP。提供五項功能:列出可存取的帳號、執行任意 GAQL 查詢、讀取廣告活動成效、讀取廣告成效,以及執行自訂查詢。需要 Google Ads 開發者權杖(審核需 1-3 個工作天)以及 OAuth 或服務帳號驗證。

為什麼要用

核心特性

即時演示

實際使用效果

google-ads.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-ads",
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "google-ads": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-google-ads"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add google-ads -- uvx mcp-google-ads

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: mcp-google-ads

每週跨帳號廣告活動健康度檢查

👤 付費行銷經理、廣告代理商 ⏱ ~20 min intermediate

何時使用: 每週定期執行——找出哪些廣告活動點閱率低、每次轉換費用高,卻仍在持續消耗預算?

前置條件
  • 已通過審核的 Google Ads 開發者權杖 — 前往 ads.google.com > 工具 > API 中心申請,需等待 1-3 個工作天
  • 已取得 Ads 存取權限的 OAuth 用戶端或服務帳號 — 透過 Google Cloud Console 建立
步驟
  1. 列出帳號
    列出我可以存取的所有 Google Ads 帳號。✓ 已複製
    → 顯示 MCC 及子帳號清單
  2. 拉取成效資料
    針對每個帳號,拉取近 7 天的資料:廣告活動名稱、費用、點擊數、轉換數、每次轉換費用。標示每次轉換費用超過 $100 的廣告活動。✓ 已複製
    → 依優先順序排列的問題廣告活動清單
  3. 提出行動建議
    針對表現最差的 3 個廣告活動,根據數據建議:暫停、降低出價,或進一步深入調查。✓ 已複製
    → 具體行動計畫

結果: 在幾分鐘內完成每週問題廣告活動審查。

注意事項
  • 不同轉換動作的歸因視窗可能不同 — 加入 segments.conversion_action_name 欄位,並分別檢視每個轉換動作
搭配使用: notion

挖掘搜尋字詞以建立否定關鍵字

👤 效果行銷人員 ⏱ ~15 min intermediate

何時使用: 定期執行帳號維護——在無效查詢持續累積費用之前,及早發現並排除。

步驟
  1. 拉取搜尋字詞
    使用 GAQL 查詢 search_term_view,時間範圍為近 30 天,欄位包含 [search_term, campaign, cost, conversions]。篩選條件:費用 > $10 且轉換數 = 0。✓ 已複製
    → 無效查詢字詞清單
  2. 分組並提出建議
    依重複出現的詞組進行分組,建議在帳號層級或廣告活動層級加入哪些否定關鍵字。✓ 已複製
    → 附帶建議層級的否定關鍵字清單

結果: 一份可直接套用的否定關鍵字清單。

注意事項
  • 廣泛比對的否定關鍵字可能會封鎖正當流量 — 優先使用完全比對或詞組比對的否定關鍵字;只有在非常確定時才使用廣泛比對

稽核廣告活動中各廣告文案的成效

👤 文案撰寫者、PPC 負責人 ⏱ ~15 min intermediate

何時使用: 當您已投放 3 個回應式搜尋廣告,想了解哪些組合表現較佳時。

步驟
  1. 拉取廣告統計資料
    針對廣告活動 X,列出所有廣告及其近 30 天的點閱率與轉換率,並依轉換率由高到低排序。✓ 已複製
    → 廣告成效排行榜
  2. 提出建議
    表現最佳的廣告文案有哪些共同特點?我應該針對哪些方向進行反覆優化?✓ 已複製
    → 文案撰寫洞察

結果: 以數據為依據的廣告創意優化方向。

注意事項
  • 資料量少的廣告因統計變異,表現看起來可能比實際差 — 比較點閱率或轉換率前,要求至少累積 100 次曝光

組合

與其他 MCP 搭配,撬動十倍槓桿

google-ads + notion

每週行銷摘要報告

拉取上週 Google Ads 成效資料及最大的成長點與衰退點,並在「Marketing Weekly」中建立一個 Notion 頁面。✓ 已複製
google-ads + postgres

將 Google Ads 資料與資料庫結合,實現全漏斗檢視

取得廣告活動 X 在 Google Ads 中的轉換數量,再查詢資料庫中來自該廣告活動的實際成交訂單數。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_accessible_accounts 探索帳號架構圖 1 API call
run_gaql customer_id, query: str 執行任何自訂報表 1 API call
campaign_performance customer_id, date_range 快速查看廣告活動摘要 1 API call
ad_performance customer_id, campaign_id?, date_range 廣告創意稽核 1 API call

成本與限制

運行它的成本

API 配額
Google Ads API:每日配額充裕;但有每秒查詢次數(QPS)的速率限制
每次呼叫 Token 數
回傳結果量取決於日期範圍與分析維度,建議限制回傳筆數
費用
API 本身免費;廣告費用另計
提示
GAQL 查詢請務必加入日期範圍。未加 LIMIT 條件可能回傳超過 10 萬筆資料。

安全

權限、密鑰、影響範圍

最小權限: Read-only on the Ads accounts where possible
憑證儲存: 服務帳號 JSON 憑證或 OAuth 更新權杖——請存放於環境變數或金鑰管理服務中
資料出站: 成效資料會傳送至您的 LLM 服務供應商
切勿授予: Admin on the Ads account to an agent that does more than read

故障排查

常見錯誤與修復

AUTHENTICATION_ERROR or PERMISSION_DENIED

服務帳號電子郵件尚未加入 MCC 並授予存取權限,或開發者權杖填寫有誤。請至 ads.google.com > 存取與安全性 進行確認。

Too many metrics for segment

GAQL 對於哪些指標可以與哪些分析維度組合使用有所限制。請簡化查詢,只選取部分欄位。

驗證: Read the GAQL compatibility table
Test token quota exceeded

申請正式環境權杖;在取得之前,請針對較小的帳號以較低的查詢頻率進行測試。

替代方案

mcp-google-ads 對比其他方案

替代方案何時用它替代權衡
Google Ads UI / Editor您只是偶爾需要拉取報表需手動操作;無法取得 LLM 分析洞察
Meta Ads MCP您同時也在投放 Meta 廣告屬於不同平台;需要獨立的驗證流程

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills