전문가 수준의 Google Ads 캠페인 분석을 위한 Claude Code Skill + MCP 서버 설정. GAQL 쿼리 템플릿, 품질 점수 진단, Smart Bidding 평가, Performance Max Deep dives 및 12 참조 문서를 포함합니다.

그것은 무엇을

설치될 때, Claude 부호는 할 수 있습니다:

**Read & Analyze : **

• GAQL (Google Ads Query Language)를 사용하여 Google Ads 계정을 직접 쿼리하십시오.
• Analyze 캠페인, 광고 그룹, 키워드 및 검색 용어 성능
• 구성 요소 수준에서 품질 점수 문제 진단 (expected CTR, 광고 relevance, 방문 페이지)
• 증발 예산 대 순위 기회를 확인하려면
• Smart Bidding 성능 및 학습 상태 분석
• 딥 다이브 성능 최대 캠페인 (소형 그룹, 광고 강도, cannibalization)
• 검색 조건 보고 및 부정 키워드 격차 확인
• 구조화 된 분석 보고서를 우선 추천

** 쓰기 및 관리:**

• 캠페인에 부정적인 키워드 추가 (Broad, Phrase, 또는 Exact match)
• 일시 중지 또는 캠페인, 광고 그룹 및 개별 광고 활성화
• 일일 예산 업데이트
• 변경 입찰 전략 (Target CPA, Target ROAS, 최대 변환, 최대 변환 값)

부품

Google Ads Analyzer for Claude Code

A Claude Code skill + MCP server setup for expert-level Google Ads campaign analysis. Includes GAQL query templates, Quality Score diagnostics, Smart Bidding evaluation, Performance Max deep dives, and 12 reference documents.

What It Does

When installed, Claude Code can:

Read & Analyze:

• Query your Google Ads accounts directly using GAQL (Google Ads Query Language)
• Analyze campaign, ad group, keyword, and search term performance
• Diagnose Quality Score issues at the component level (expected CTR, ad relevance, landing page)
• Evaluate Impression Share to identify budget vs rank opportunities
• Assess Smart Bidding performance and learning status
• Deep dive Performance Max campaigns (asset groups, ad strength, cannibalization)
• Review search term reports and identify negative keyword gaps
• Generate structured analysis reports with prioritized recommendations

Write & Manage:

• Add negative keywords to campaigns (Broad, Phrase, or Exact match)
• Pause or enable campaigns, ad groups, and individual ads
• Update daily budgets
• Change bidding strategies (Target CPA, Target ROAS, Maximize Conversions, Maximize Conversion Value)

Components

Prerequisites

• Claude Code installed
• Python 3.8+
• uv (Python package manager — the MCP server runs via uvx)
• A Google Ads account (with a Developer Token)
• A Google Cloud project with the Google Ads API enabled

Installation

Step 1: Install the Skill

Copy the skill/ folder into your Claude Code project:

# From your Claude Code project root
mkdir -p .claude/skills/google-ads-analyzer
cp -r skill/* .claude/skills/google-ads-analyzer/

The skill is now active. Claude will automatically use it when you ask about Google Ads analysis.

Step 2: Set Up a Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project (or use an existing one)
3. Enable the Google Ads API:
   • Go to APIs & Services → Library
   • Search for “Google Ads API”
   • Click Enable
4. Create an OAuth 2.0 Client ID:
   • Go to APIs & Services → Credentials
   • Click “Create Credentials” → OAuth Client ID
   • Application type: Desktop app
   • Download the JSON file

Step 3: Get a Developer Token

This is required to access the Google Ads API. It’s separate from OAuth credentials.

1. Sign in to your Google Ads manager account (MCC)
2. Go to Tools & Settings → Setup → API Center