v2.1.0 — Comprehensive Wiki + Capability Documentation

What's New

15-Page Wiki Documentation

The full wiki is now live at github.com/itallstartedwithaidea/google-ads-api-agent/wiki:

• Home — Navigation hub with Repo vs MCP vs Buddy capability comparison
• Quick Start — Install, configure, run in 5 minutes
• Credentials Setup — Google Ads, Anthropic, Cloudinary, SearchAPI, Gemini
• Architecture Overview — System design, data flow, ReAct loop patterns
• Buddy Architecture — Cloudflare production stack (DO, Agents SDK, D1, R2, Vectorize)
• Tool Reference — All 21 tools with parameters
• Read Tools — 47 GAQL queries documented
• Write Tools — 62 mutation operations with CEP safety protocol
• AI Tools — Web search, keyword research, URL scanning, PageSpeed, creative builder
• Sub-Agents — 6 specialists (Simba, Nemo, Elsa, Aladdin, Moana, Baymax)
• GAQL Query Reference — Full SQL for all 47 queries
• Mutation Reference — Detailed parameter tables for all 62 writes
• Security — CORS, rate limiting, AES-256-GCM, SSRF, XSS protections
• API Endpoints — Python REST API + Cloudflare Pages Functions
• Troubleshooting — Common issues and debugging

Documentation Accuracy Updates

• Corrected tool counts: 21 tools, 47 reads, 62 writes
• Complete tool inventory table in BUDDY_ARCHITECTURE.md
• Updated Python-to-Buddy mapping with all capabilities

Capability Audit

Full audit confirmed Buddy covers all 23 MCP tools plus 24 additional reads, 51 additional writes, 12 AI tools, semantic memory, real-time WebSocket, billing, encrypted storage, Merchant Center, and automated monitoring.

Full changelog: CHANGELOG.md

Google Ads API Agent v1.0

Enterprise-grade Google Ads management agent running on Claude Opus. 28 custom actions, 6 Disney-named sub-agents.

v2.0.0 — Buddy Security Hardening + Production Architecture

What's New in v2.0.0

This release brings all the security hardening and production architecture learnings from the Buddy agent — the Cloudflare-based production deployment that's been live since February 2026.

🔒 Security Fixes

• CORS hardening — No more wildcard * origins. Configure allowed domains via ALLOWED_ORIGINS env var
• Rate limiting — Built-in IP-based rate limiter (30 req/min, configurable)
• Error sanitization — Server returns generic errors; full details logged internally
• Input validation — GAQL injection prevention via period whitelisting
• Write safety — CEP Protocol (Confirm → Execute → Post-check) for all mutations

📦 Now a Pip Package

pip install google-ads-agent

Or install with extras:

pip install "google-ads-agent[all]"   # server + creative + cli
pip install "google-ads-agent[server]" # FastAPI server only

📄 New Documentation

• LICENSE — MIT license (previously missing)
• SECURITY.md — Vulnerability reporting + security best practices
• CONTRIBUTING.md — How to contribute, priority areas, code style
• CHANGELOG.md — Version history
• .env.example — Complete credential template
• docs/BUDDY_ARCHITECTURE.md — Full Cloudflare production architecture reference

🏗️ Buddy Architecture Reference

The new docs/BUDDY_ARCHITECTURE.md documents the production Cloudflare system:

• Durable Objects for per-user state
• Semantic memory via Vectorize embeddings
• Encrypted API key storage (AES-256-GCM)
• Automated monitoring (health checks, anomaly detection)
• Credit-based billing with Stripe
• Multi-provider AI (Claude, GPT, Gemini)

This serves as a blueprint for contributors building these features in Python.

⬆️ Upgrade Guide

No breaking changes from v1.0. Just pull the latest and set your ALLOWED_ORIGINS env var if deploying the server.

---

Full Changelog: b9a22c1...v2.0.0