CM

cohnen/mcp-google-ads

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

718 stars 158 forks 品質 72 トレンド 22MIT

Google広告とClaude AI/カーソルなどを連携させ、自然言語の会話を通じて広告データを分析できるMCPツールです。

概要

Google AdsとClaude AIをつなぐツールで、自然な言語の会話を通じて広告データを分析できます。この統合により、キャンペーン情報、パフォーマンス指標、キーワード分析、広告管理をClaudeとの簡単なチャットで行えます。 1. - Google広告のすべてのアカウントを一か所で確認 - アカウント詳細と基本的なキャンペーン情報を取得 2. - どのキャンペーンが最もパフォーマンスが良いかを発見 - インプレッション、クリック、コンバージョン、コスト指標を追跡 - 時間軸のパフォーマンス傾向を分析 - 異なる期間を比較して変化を察知 - Claudeで作成したチャートやグラフで 3. - 上位およびパフォーマンスが低いキーワードを特定する - 広告コピーの効果を分析する - 品質スコアと競合指標の確認 - キャンペーンを改善するための実践的な洞察を得る 4.

概要(AI 翻訳)

Google AdsとClaude AIをつなぐツールで、自然な言語の会話を通じて広告データを分析できます。この統合により、キャンペーン情報、パフォーマンス指標、キーワード分析、広告管理をClaudeとの簡単なチャットで行えます。


このツールは広告の専門家に何ができるのか?

  1. アカウント管理
  • すべてのGoogle広告アカウントを一か所で確認すること
  • アカウント詳細および基本的なキャンペーン情報の取得
  1. キャンペーン分析と報告
  • どのキャンペーンが最も良いパフォーマンスを出しているかを発見する
  • インプレッション、クリック、コンバージョン、コスト指標の追跡
  • 時間経過したパフォーマンストレンドの分析
  • 異なる時間帯とスポットの変化を比較する
  • Claudeが作成したチャートやグラフでデータを可視化
  1. キーワードと広告パフォーマンス
  • トップおよびパフォーマンスが低いキーワードを特定する
  • 広告コピーの効果を分析する
  • 品質スコアと競合指標の確認
  • キャンペーン改善のための実用的なインサイトを得る
  1. 予算と入札管理
  • 選挙予算と支出の監視
  • 入札戦略とパフォーマンスの分析
  • 最適化の機会を特定する

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Google Ads MCP

A tool that connects Google Ads with Claude AI, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all through simple chat with Claude.


What Can This Tool Do For Advertising Professionals?

  1. Account Management

    • See all your Google Ads accounts in one place
    • Get account details and basic campaign information
  2. Campaign Analytics & Reporting

    • Discover which campaigns are performing best
    • Track impressions, clicks, conversions, and cost metrics
    • Analyze performance trends over time
    • Compare different time periods to spot changes
    • Visualize your data with charts and graphs created by Claude
  3. Keyword & Ad Performance

    • Identify top and underperforming keywords
    • Analyze ad copy effectiveness
    • Check quality scores and competitive metrics
    • Get actionable insights on how to improve your campaigns
  4. Budget & Bid Management

    • Monitor campaign budgets and spending
    • Analyze bid strategies and performance
    • Identify opportunities for optimization
    • Get recommendations for budget allocation

flowchart TB
    User(User) -->|Interacts with| Claude
    Claude(Claude AI Assistant) -->|Makes requests to| MCP[Google Ads MCP Server]
    User -->|Can also use| Cursor[Cursor AI Code Editor]
    Cursor -->|Makes requests to| MCP
    
    subgraph "MCP Server"
        FastMCP[FastMCP Server] 
        Tools[Available Tools]
        Auth[Authentication]
        
        FastMCP -->|Exposes| Tools
        FastMCP -->|Uses| Auth
    end
    
    subgraph "Google Ads Tools"
        ListAccounts[list_accounts]
        ExecuteGAQL[execute_gaql_query]
        CampaignPerf[get_campaign_performance]
        AdPerf[get_ad_performance]
        RunGAQL[run_gaql]
    end
    
    Tools -->|Includes| ListAccounts
    Tools -->|Includes| ExecuteGAQL
    Tools -->|Includes| CampaignPerf
    Tools -->|Includes| AdPerf
    Tools -->|Includes| RunGAQL
    
    subgraph "Authentication"
        OAuth[OAuth 2.0 Client ID]
        ServiceAccount[Service Account]
        Credentials[Google Ads API Credentials]
        
        OAuth -->|Provides| Credentials
        ServiceAccount -->|Provides| Credentials
    end
    
    MCP -->|Communicates with| GoogleAdsAPI[Google Ads API]
    GoogleAdsAPI -->|Returns| AdData[Advertising Data]
    AdData -->|Analyzed by| Claude
    AdData -->|Visualized by| Claude
    AdData -->|Can be used by| Cursor
    
    Credentials -->|Authorizes| GoogleAdsAPI
    
    subgraph "Configuration"
        EnvVars[Environment Variables]
GitHub で README 全文を見る

インストール

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

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "googleAdsServer": { "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python", "args": ["/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"], "env": { "GOOGLE_ADS_AUTH_TYPE": "oauth", "GOOGLE_ADS_CREDENTIALS_PATH": "/FULL/PATH/TO/mcp-google-ads-main/credentials.json", "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN_HERE", "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE" } } } }