CM

cohnen/mcp-google-ads

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

718 stars 158 forks 품질 72 트렌드 22MIT

Google Ads를 Claude AI/커서 등과 연결하여 자연어 대화를 통해 광고 데이터를 분석할 수 있게 해주는 MCP 도구입니다.

개요

구글 광고와 Claude AI를 연결하여 자연어 대화를 통해 광고 데이터를 분석할 수 있는 도구입니다. 이 통합을 통해 캠페인 정보, 성과 지표, 키워드 분석, 광고 관리를 Claude와의 간단한 채팅으로 모두 이용할 수 있습니다. 1. - 모든 Google Ads 계정을 한 곳에서 볼 수 있어 - 계정 정보와 기본 캠페인 정보 확인 2. - 어떤 캠페인이 가장 잘 수행되고 있는지 발견하기 - 노출, 클릭, 전환, 비용 지표를 추적하기 - 시간에 따른 성과 추세 분석 - Claude가 만든 차트와 트레이트로 다양한 기간을 비교해 변화를 발견하기 3. - 상위 및 저성능 키워드 식별 - 광고 카피 효과 분석 - 품질 점수 및 경쟁 지표 확인 - 캠페인 개선 방법에 대한 실행 가능한 인사이트 확보 4.

개요(AI 번역)

구글 광고와 Claude AI를 연결하여 자연어 대화를 통해 광고 데이터를 분석할 수 있는 도구입니다. 이 통합을 통해 캠페인 정보, 성과 지표, 키워드 분석, 광고 관리를 Claude와의 간단한 채팅으로 모두 이용할 수 있습니다.


이 도구는 광고 전문가들에게 무엇을 할 수 있을까요?

  1. 계정 관리
  • 모든 구글 광고 계정을 한 곳에서 볼 수 있습니다
  • 계정 정보 및 기본 캠페인 정보 확인
  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" } } } }