エキスパートレベルのGoogle広告キャンペーン分析のためのClaudeコードスキル+ MCPサーバーセットアップ。 GAQLのクエリテンプレート、品質スコア診断、スマート入札評価、パフォーマンス最大深層ダイブ、および12の参照文書が含まれています。

それが何をしているか

インストールすると、Claudeコードは次のことができます。

読み込みと分析:

• GAQL(Google Ads Query Language)を使用してGoogle Adsアカウントを直接問い合わせる
• キャンペーン、広告グループ、キーワード、検索期間のパフォーマンスを分析
• コンポーネントレベルの品質スコアの問題を診断(CTR、関連性、ランディングページ)
• 印象を評価する 予算とランクの機会を識別するための共有
• スマート入札性能と学習状況を評価する
• ディープ・ダイブ・パフォーマンス・マックス・キャンペーン(アセット・グループ、広告力、キャニバル化)
• 検索用語のレポートを見直し、マイナスキーワードのギャップを特定する
• 構造解析レポートを優先的に作成

書き込みと管理:

• キャンペーンにネガティブなキーワードを追加(ブロード、フレーズ、またはExactマッチ)
• キャンペーン、広告グループ、および個々の広告の再利用または有効化
• 毎日の予算を更新する
• 入札戦略を変更(CPAをターゲット、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