AHMEEGO™ — Open Source Google Ads API Agent
28 Tools · 6 Sub-Agents · Live API Access · Built on Claude
View on GitHub ↗ · llms.txt · llms-full.txt
An open-source, enterprise-grade AI agent that manages Google Ads accounts through the API. 28 custom Python actions, 6 specialized sub-agents, live read/write access to real Google Ads accounts. Built on Claude by Anthropic. Free to use.
Built by John Williams — Senior Paid Media Specialist at Seer Interactive with 15+ years managing $350M+ in digital advertising spend.
Full architecture documentation ↗
Each action is a standalone Python file in actions/main-agent/ — real Google Ads API calls with read and write access.
Credential Patterns: A = 5-key Google Ads (12 actions), B = 4-key Google Ads (13 actions), C = 3-key Cloudinary (1 action), D = No credentials (2 actions)
Named after Disney characters. System prompts in prompts/sub-agents/, actions in actions/sub-agents/
git clone https://github.com/itallstartedwithaidea/google-ads-api-agent.git cd google-ads-api-agent python -m venv venv && source venv/bin/activate pip install -r requirements.txt cp .env.example .env python scripts/validate.py python scripts/cli.py
Required: Anthropic API Key + Google Ads API (5 keys)
Optional: Cloudinary · SearchAPI.io · Google AI / Gemini
Interactive CLI: python scripts/cli.py · REST API: uvicorn deploy.server:app --port 8000 · Docker: docker compose up · Python SDK: from deploy import create_agent_system
python scripts/cli.py
uvicorn deploy.server:app --port 8000
docker compose up
from deploy import create_agent_system
66 files across 12 directories. View on GitHub ↗
Built by John Williams — Senior Paid Media Specialist at Seer Interactive with 15+ years managing $350M+ in digital advertising spend across Google Ads, Meta, Microsoft, Amazon, and other platforms. Former NortonLifeLock (192% YoY paid search growth), Gen Digital, Farmers Insurance. Conference speaker at Hero Conf 2025 + 2026 on AI applications in advertising.
GitHub · LinkedIn · X / Twitter · Instagram · Substack · Reddit · itallstartedwithaidea.com
It reasons, calls, receives, validates — and loops until it has the truth.
OPEN SOURCE · 28 TOOLS · 6 SUB-AGENTS · BUILT ON CLAUDE · ahmeego.com
Paid media
Nonprofits
Measurement
SEO & web
Commerce & systems
Explore
Elsewhere