MG

mathiaschu/google-ads-analyzer

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

71 stars 17 forks Качество 55 Тренд 14MIT

Настройка сервера Claude Code + MCP для анализа кампании Google Ads на уровне экспертов

Обзор

Настройка сервера Claude Code + MCP для анализа кампании Google Ads на уровне экспертов. Включает шаблоны запросов GAQL, диагностику оценки качества, оценку Smart Bidding, глубокие погружения Performance Max и 12 справочных документов. Запросите свои учетные записи Google Ads непосредственно с использованием GAQL (язык запросов Google Ads) - Анализ кампании, группы объявлений, ключевых слов и производительности поискового запроса - Диагностика проблем с качеством на уровне компонентов (ожидаемый CTR, релевантность рекламы, целевая страница) - Оценка впечатлений Share to identify budget vs rank opportunities - Assess Smart Bidding performance and learning status - Deep dive Performance Max campaigns (активные группы, рекламная сила, каннибализация) - Обзор отчетов по поисковым запросам и выявление негативных пробелов в ключевых словах - Создание структурированных аналитических отчетов с приоритетными рекомендациями Добавьте негативные ключевые слова в кампании (широкое, фразовое или точное соответствие) - приостановите или включите кампании, группы объявлений и отдельные объявления - Обновите ежедневные бюджеты - Измените стратегии торгов.

Обзор (машинный перевод)

Настройка сервера Claude Code + MCP для анализа кампании Google Ads на уровне экспертов. Включает шаблоны запросов GAQL, диагностику оценки качества, оценку Smart Bidding, глубокие погружения Performance Max и 12 справочных документов.

Что это делает

При установке Claude Code может:

Читать и анализировать: Запросите свои учетные записи Google Ads напрямую с помощью GAQL (язык запросов Google Ads) Анализ кампании, группы объявлений, ключевых слов и производительности поискового термина

  • Диагностика показателей качества на уровне компонентов (ожидаемый CTR, релевантность рекламы, целевая страница)
  • Оценка впечатлений Доля для определения возможностей бюджета и ранга
  • Оценка эффективности умных торгов и статуса обучения
  • Кампании Deep Dive Performance Max (группы активов, рекламная сила, каннибализация) Обзор отчетов о поисковых терминах и выявление негативных пробелов в ключевых словах Создание отчетов по структурированному анализу с приоритетными рекомендациями

Письмо и управление: Добавление негативных ключевых слов в кампании (широкий, фразовый или точный матч) Приостановить или включить кампании, группы объявлений и отдельные объявления Обновление ежедневных бюджетов

  • Изменение стратегий торгов (Целевой CPA, Целевой ROAS, Максимальная конверсия, Максимальная стоимость конверсии)

Компоненты

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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

Component What it does
Skill (skill/) Analysis framework with 12 reference docs that Claude loads as context
MCP Server Fork of google-ads-mcp with 6 write tools — connects Claude Code to the Google Ads API for reading and managing campaigns
Scripts (scripts/) OAuth setup helper

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
Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →