-
Notifications
You must be signed in to change notification settings - Fork 4
Home
John Williams edited this page Mar 6, 2026
·
2 revisions
An enterprise-grade, AI-powered Google Ads management system with 250+ API actions, 6 specialized sub-agents, and live read/write access to Google Ads accounts.
Live at: googleadsagent.ai
MCP Server: google-ads-mcp
- Quick Start — Install, configure, and run in 5 minutes
- Credentials Setup — Google Ads API, Cloudinary, SearchAPI, Gemini
- Architecture Overview — System design, data flow, and components
- Buddy Architecture — Cloudflare production system (Durable Objects, Agents SDK, D1, R2)
- Tool Reference — All 47 read queries + 62 write operations
- Read Tools — 47 GAQL queries for pulling Google Ads data
- Write Tools — 62 mutation operations (campaigns, ads, keywords, budgets, etc.)
- AI Tools — Web search, keyword research, URL scanning, PageSpeed, creative builder
- Sub-Agents — 6 specialist agents (Reporting, Research, Optimization, Shopping, Creative, Baymax)
- Path A — Anthropic API — Programmatic deployment with Python
- Path B — Agent Platform — Visual builder deployment
- Path C — Cloudflare Production — Full-stack Buddy deployment
- GAQL Query Reference — All 47 Google Ads Query Language queries
- Mutation Reference — All 62 write operations with parameters
- Security — CORS, rate limiting, encryption, write safety
- API Endpoints — REST API reference for the FastAPI server
- Troubleshooting — Common issues and fixes
| Component | Count | Description |
|---|---|---|
| GAQL Read Queries | 47 | Account, campaign, keyword, search term, audience, device, geo, video, shopping, PMax, placement, conversion data |
| Write Operations | 62 | Campaign CRUD, keyword management, bidding, budgets, extensions, labels, audiences, Merchant Center |
| AI Tools | 12 | Web search, keyword research, URL scan, PageSpeed, creative builder, document storage, task management |
| Sub-Agents | 6 | Reporting, Research, Optimization, Shopping/PMax, Creative, Creative Innovate |
| Google Ads API | v22 | Full REST API coverage via googleads.googleapis.com
|
| Merchant Center | v2.1 | Product CRUD via Content API |
| Capability | This Repo (Python) | MCP Server | Buddy (Production) |
|---|---|---|---|
| Read queries | 47 | 23 | 47 |
| Write operations | 62 | 11 | 62 |
| Sub-agents | 6 | — | 6 |
| Semantic memory | — | — | Vectorize |
| Real-time WebSocket | — | — | Agents SDK |
| Credit billing | — | — | D1 + Stripe |
| Encrypted key storage | — | — | AES-256-GCM |
| Web search/trends | SearchAPI | — | SearchAPI |
| URL scanning | — | — | GA4, GTM, Meta, consent |
| PageSpeed | — | — | Core Web Vitals |
| Keyword Planner | — | Yes | Yes |
| Offline conversions | — | — | GCLID upload |
| Customer Match | — | — | Email/phone lists |
| Merchant Center | — | — | 5 operations |
Built by John Williams · googleadsagent.ai