ads-google
Originally fromagricidaniel/claude-ads
Installation
SKILL.md
Google Ads Deep Analysis
Data Collection (3-tier free-first)
- Capa 1 — MCP (preferred):
cohnen/mcp-google-adsfor GAQL access. Pull Search Terms Report, keyword data, conversion actions, campaign structure automatically. Seemcp-integration.mdfor setup. - Capa 2 — Direct API (free; OAuth + developer-token setup): if
google-data.jsonis present in cwd, read it. The user generates it with:
Full setup (developer token application takes 1-3 business days) inpython3 scripts/api/google_fetch.py --account-id <customer_id> -o google-data.jsonscripts/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).