ads-google

Installation
SKILL.md

Google Ads Deep Analysis

Data Collection (3-tier free-first)

  • Capa 1 — MCP (preferred): cohnen/mcp-google-ads for GAQL access. Pull Search Terms Report, keyword data, conversion actions, campaign structure automatically. See mcp-integration.md for setup.
  • Capa 2 — Direct API (free; OAuth + developer-token setup): if google-data.json is present in cwd, read it. The user generates it with:
    python3 scripts/api/google_fetch.py --account-id <customer_id> -o google-data.json
    
    Full setup (developer token application takes 1-3 business days) in scripts/api/README.md.
  • Capa 3 — Manual fallback: Google Ads account export including Change History and Search Terms Report.
  • Validate before evaluating: data covers ≥30 days AND includes the Search Terms Report. If not, stop and request a fresh export.

Then follow the standard 7-step audit process in ads/references/audit-methodology.md using google-audit.md as the check list. Before any GAQL analysis, read gaql-notes.md for known field incompatibilities and deduplication rules. Emit dual output (google-audit-results.json against audit-output-schema.json, plus google-audit-results.md).

What to Analyze

Installs
18
GitHub Stars
32
First Seen
Apr 30, 2026
ads-google — hainrixz/claude-ads