grantweston/google-ads-mcp-complete

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

26 stars 12 forks 质量 66 趋势 11MIT

Repository Install

完整的 Google Ads API v21 MCP 服务器——所有宣传工具全部实际运行的完整实现

概览

- 40+ 工具，具备完全自动化功能！一个全面的模型上下文协议（MCP）服务器，提供对 Google Ads API v21 功能的完全访问权限。该服务器使 AI 助手能够通过自然语言命令实现完全自动化，创建、优化和管理 Google Ads 广告活动。与其他只提供接口而无实现的仓库不同，每一个工具实际上都完全兼容 Google Ads API v21： ✅ - 完整的活动自动化 ✅ - 所有✅最新功能和修复 - 成功大规模管理真实活动 ✅ - 从创建到优化✅的完整活动生命周期 - 稳健的重试逻辑和详细错误 ✅ - 示例和语法指南 - - 列出所有可访问的谷歌广告账户 - - 详细账户信息及优化评分 - - 完整的账户结构和关系 - - 创建带有高级定向和竞价功能的活动 - - 更新设置，包括投资组合竞价策略......

概述（AI 翻译）

** 🎉 完全功能** - 40+工具，具备完全自动化功能！

一个全面的模型上下文协议（MCP）服务器，提供对 Google Ads API v21 功能的完全访问权限。该服务器使 AI 助手能够通过自然语言命令实现完全自动化，创建、优化和管理 Google Ads 广告活动。

🚀 这有什么不同

这是一个完整的实现！ 与其他只提供接口而没有实现的仓库不同，每一个工具实际上都支持完整的 Google Ads API v21 兼容性：

✅ 40+ 工具已实现 - 完整的活动自动化 ✅ 100% API v21兼容 - 所有最新功能和修复 ✅ 生产测试 - 成功大规模管理真实活动 ✅ 高级自动化——从创建到优化的完整活动生命周期 ✅ 全面的错误处理——稳健的重试逻辑和详细错误 ✅ 完整文档 - 示例和语法指南

🛠️ 完整工具组（45+工具）

🏢 账户管理（3个工具）

list_accounts - 列出所有可访问的谷歌广告账户

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Complete Google Ads API v21 MCP Server

🎉 FULLY FUNCTIONAL - 40+ tools implemented with complete automation capabilities!

A comprehensive Model Context Protocol (MCP) server that provides full access to Google Ads API v21 functionality. This server enables AI assistants to create, optimize, and manage Google Ads campaigns with complete automation through natural language commands.

🚀 What Makes This Different

This is a COMPLETE implementation! Unlike other repositories that only provide interfaces without implementations, every single tool actually works with full Google Ads API v21 compatibility:

✅ 40+ Tools Implemented - Complete campaign automation
✅ 100% API v21 Compatible - All latest features and fixes
✅ Production Tested - Successfully manages real campaigns at scale
✅ Advanced Automation - Full campaign lifecycle from creation to optimization
✅ Comprehensive Error Handling - Robust retry logic and detailed errors
✅ Complete Documentation - Examples and syntax guides

🛠️ Complete Tool Set (45+ Tools)

🏢 Account Management (3 Tools)

list_accounts - List all accessible Google Ads accounts
get_account_info - Detailed account information with optimization scores
get_account_hierarchy - Complete account structure and relationships

🎯 Campaign Management (10 Tools)

create_campaign - Create campaigns with advanced targeting and bidding
update_campaign - Update settings including portfolio bidding strategy assignment
pause_campaign / resume_campaign - Campaign lifecycle management
list_campaigns - Filter and search campaigns with performance data
get_campaign - Comprehensive campaign details and metrics
delete_campaign - Safe campaign removal
copy_campaign - Duplicate campaigns with new budgets
create_ad_schedule - Advanced dayparting with bid adjustments
get_campaign_overview - Complete dashboard showing campaign structure, keywords, extensions, optimization score

📁 Ad Group Management (3 Tools)

create_ad_group - Create ad groups with custom bidding
update_ad_group - Modify ad group settings and bids
list_ad_groups - Browse ad groups with filters

📝 Advanced Ad Management (10 Tools)

create_responsive_search_ad - Modern responsive search ads
create_expanded_text_ad - Traditional expanded text ads
list_ads / update_ad / pause_ad / enable_ad / delete_ad - Complete ad lifecycle
compare_ad_performance - Side-by-side ad performance analysis
get_ad_group_performance_ranking - Rank ads by efficiency metrics
identify_optimization_opportunities - AI-powered optimization recommendations
calculate_roas_by_ad - Return on Ad Spend analysis with profitability insights

🧠 Keyword Intelligence (8 Tools)

add_keywords - Add keywords with custom match types and bids

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "google-ads": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/google-ads-mcp-complete/run_server.py"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_CLIENT_ID",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ID"
      }
    }
  }
}