{"id":50816721,"url":"https://github.com/itallstartedwithaidea/claude-googleadsagent","last_synced_at":"2026-06-13T10:04:38.208Z","repository":{"id":359406861,"uuid":"1245919496","full_name":"itallstartedwithaidea/claude-googleadsagent","owner":"itallstartedwithaidea","description":"Google Ads Agent — Buddy. The most comprehensive Google Ads + advertising plugin for Claude Code. Buddy + 6 sub-agents, 2 MCP servers, 77 skills, 7 commands, safety hooks, anomaly monitors. By Ahmeego.","archived":false,"fork":false,"pushed_at":"2026-05-21T18:12:05.000Z","size":443,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T03:21:38.826Z","etag":null,"topics":["advertising","ahmeego","ai-agent","anthropic","buddy","claude-code","claude-plugin","claude-plugins","gaql","google-ads","googleadsagent","itallstartedwithaidea","marketing-automation","mcp","mcp-server","performance-marketing","pmax","ppc"],"latest_commit_sha":null,"homepage":"https://www.ahmeego.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itallstartedwithaidea.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"itallstartedwithaidea","custom":["https://www.ahmeego.com"]}},"created_at":"2026-05-21T17:31:54.000Z","updated_at":"2026-05-21T18:12:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/itallstartedwithaidea/claude-googleadsagent","commit_stats":null,"previous_names":["itallstartedwithaidea/claude-googleadsagent"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/itallstartedwithaidea/claude-googleadsagent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itallstartedwithaidea%2Fclaude-googleadsagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itallstartedwithaidea%2Fclaude-googleadsagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itallstartedwithaidea%2Fclaude-googleadsagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itallstartedwithaidea%2Fclaude-googleadsagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itallstartedwithaidea","download_url":"https://codeload.github.com/itallstartedwithaidea/claude-googleadsagent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itallstartedwithaidea%2Fclaude-googleadsagent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34279899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advertising","ahmeego","ai-agent","anthropic","buddy","claude-code","claude-plugin","claude-plugins","gaql","google-ads","googleadsagent","itallstartedwithaidea","marketing-automation","mcp","mcp-server","performance-marketing","pmax","ppc"],"created_at":"2026-06-13T10:04:37.113Z","updated_at":"2026-06-13T10:04:38.197Z","avatar_url":"https://github.com/itallstartedwithaidea.png","language":"JavaScript","funding_links":["https://github.com/sponsors/itallstartedwithaidea","https://www.ahmeego.com"],"categories":["Source Catalog"],"sub_categories":[],"readme":"# Google Ads Agent — Buddy\n\n\u003e The most comprehensive Google Ads + advertising automation plugin for Claude Code.\n\u003e By [**Ahmeego**](https://www.ahmeego.com) · [`itallstartedwithaidea`](https://github.com/itallstartedwithaidea) · powered by **Buddy**\n\n[![PyPI](https://img.shields.io/pypi/v/googleadsagent-mcp.svg?label=googleadsagent-mcp)](https://pypi.org/project/googleadsagent-mcp/)\n[![npm](https://img.shields.io/npm/v/@googleadsagent/ad-creative-mcp.svg?label=%40googleadsagent%2Fad-creative-mcp)](https://www.npmjs.com/package/@googleadsagent/ad-creative-mcp)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-7c3aed.svg)](https://code.claude.com/docs/en/plugin-marketplaces)\n[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)\n\n---\n\n## What you get\n\n- **Buddy** — flagship Opus-powered Google Ads enterprise agent with live API access\n- **6 specialized sub-agents** (Simba, Nemo, Elsa, Aladdin, Moana, Baymax) covering reporting, research, optimization, Shopping/PMax, creative, and creative-innovate\n- **2 MCP servers** — `googleadsagent-mcp` (Google Ads API) and `@googleadsagent/ad-creative-mcp` (Cloudinary-backed creative validation)\n- **~77 production skills** across Google Ads, AI agent engineering, Claude mythos, software dev, security, infrastructure, productivity, web frontend, scientific research, and media creative\n- **7 slash commands** — `/analyze`, `/audit`, `/optimize`, `/status`, `/login`, `/logout`, `/switch`\n- **Safety hooks** — `PreToolUse` GAQL validation prevents write operations from read-only contexts, `PostToolUse` audit logging\n- **Background anomaly monitor** — surfaces CPA spikes, CTR drops, and zero-conversion spend in real time\n- **Buddy as the default agent** — `settings.json` activates Buddy immediately on plugin load\n\n\u003e Built by a practitioner with $350M+ in managed ad spend across Google, Meta, Microsoft, and Amazon.\n\u003e Reference architecture is the production system behind [`ahmeego.com`](https://www.ahmeego.com).\n\n---\n\n## Install (one command)\n\nOnce the plugin is approved in Anthropic's community marketplace:\n\n```shell\n/plugin marketplace add anthropics/claude-plugins-community\n/plugin install googleadsagent@claude-community\n```\n\n### Self-hosted install (available immediately)\n\n```shell\n/plugin marketplace add itallstartedwithaidea/claude-googleadsagent\n/plugin install googleadsagent@claude-googleadsagent\n```\n\n### Local dev install\n\n```bash\ngit clone https://github.com/itallstartedwithaidea/claude-googleadsagent\nclaude --plugin-dir ./claude-googleadsagent\n```\n\n---\n\n## Authentication\n\nThe Google Ads MCP server needs OAuth credentials. Copy `.env.example` to `.env` and fill in:\n\n| Variable | Where to get it |\n|---|---|\n| `GOOGLE_ADS_DEVELOPER_TOKEN` | [Google Ads → Tools → API Center](https://ads.google.com/aw/apicenter) |\n| `GOOGLE_ADS_CLIENT_ID` | [Google Cloud Console → OAuth 2.0 Client IDs](https://console.cloud.google.com/apis/credentials) |\n| `GOOGLE_ADS_CLIENT_SECRET` | Same as above |\n| `GOOGLE_ADS_REFRESH_TOKEN` | Run `claude-googleadsagent oauth` (see wiki) |\n| `GOOGLE_ADS_LOGIN_CUSTOMER_ID` | Your MCC account ID (no dashes) |\n\nFull walkthrough: [Wiki → Authentication](https://github.com/itallstartedwithaidea/claude-googleadsagent/wiki/Authentication)\nOr use the Ahmeego hosted OAuth flow: [ahmeego.com/docs/google-ads-auth](https://www.ahmeego.com/docs/google-ads-auth)\n\n---\n\n## Quick start\n\nInside Claude Code after installing the plugin:\n\n```shell\n# Talk to Buddy directly\n\u003e Hey Buddy, audit my Google Ads account 1234567890 for the last 30 days\n\n# Run a slash command\n/googleadsagent:audit My MCC, last 30 days, focus on PMax campaigns\n\n# Invoke a sub-agent explicitly\n\u003e @simba pull a search-term waste report for campaigns with \u003e$50 spend and zero conversions\n\u003e @aladdin which Shopping product groups are limited by budget?\n\u003e @baymax resize these display creatives for all standard IAB sizes\n\n# Use a specific skill\n/googleadsagent:keyword-research expand my \"personal injury lawyer\" keyword list with high-intent variants\n```\n\n---\n\n## What's in the box\n\n### Agents (7)\n\n| Agent | Role |\n|---|---|\n| **Buddy** | Flagship Google Ads strategist — orchestrates everything |\n| **Simba** | Reporting \u0026 analysis |\n| **Nemo** | Research \u0026 competitive intelligence |\n| **Elsa** | Bulk optimization \u0026 write ops |\n| **Aladdin** | Shopping \u0026 Performance Max |\n| **Moana** | Visual ad creative (RDA, Demand Gen) |\n| **Baymax** | Creative resizing \u0026 format conversion |\n\n### MCP servers (2)\n\n| Server | Source | Powers |\n|---|---|---|\n| `google-ads` | [`googleadsagent-mcp`](https://pypi.org/project/googleadsagent-mcp/) (PyPI) | Live Google Ads API — read, analyze, create, modify |\n| `ad-creative` | Bundled in `servers/ad-creative-mcp/server.mjs` (455KB, deps inlined) — also published as [`@googleadsagent/ad-creative-mcp`](https://www.npmjs.com/package/@googleadsagent/ad-creative-mcp) on npm | Cloudinary-backed creative validation, resizing, optimization |\n\n### Skill categories (77 skills)\n\n- **Google Ads (16)** — audit, analysis, write, math, mcp, keyword-research, ad-copy-generation, budget-optimization, pmax-optimization, shopping-ads, audience-targeting, conversion-tracking, quality-score-optimization, remarketing-strategy, competitor-analysis, landing-page-audit\n- **AI Agent Engineering (10)** — knowledge-base-injection, entity-memory-management, multi-model-routing, proactive-intelligence, mcp-server-creation, parallel-agent-orchestration, memory-persistence, continuous-learning, token-optimization, long-horizon-workflows\n- **Claude Mythos (10)** — prompt-architecture, context-engineering, anthropic-tool-mastery, cognitive-scaffolding, verification-loops, self-healing-agents, adversarial-resilience, agent-instinct-system, session-archaeology, multi-harness-portability\n- **Software Dev (8)** — code-review, test-driven-development, systematic-debugging, git-worktrees, brainstorming, subagent-driven-development, writing-plans, executing-plans\n- **Security (4)** — agent-security-scanning, codeql-semgrep, sandbox-hardening, secret-protection\n- **Infrastructure (6)** — cloudflare-workers, ci-cd-pipelines, edge-rendering, observability, service-discovery, configuration-management\n- **Productivity (6)** — workflow-orchestration, batch-processing, knowledge-base-rag, ai-chat-studio, low-code-generation, assistant-presets\n- **Web Frontend (6)** — react-best-practices, react-native-guidelines, view-transitions, edge-deployment, composition-patterns, web-design-guidelines\n- **Scientific Research (8)** — data-analysis, machine-learning, bioinformatics, cheminformatics, geospatial-analysis, research-methodology, scientific-writing, database-lookup\n- **Media Creative (3)** — web-asset-generation, programmatic-video, ml-model-integration\n\n### Slash commands (7)\n`/analyze` · `/audit` · `/optimize` · `/status` · `/login` · `/logout` · `/switch`\n\n### Hooks (2)\n- **`PreToolUse`** → validates GAQL queries before execution to block accidental writes from read-only contexts\n- **`PostToolUse`** → logs every Google Ads tool call to an audit trail\n\n### Background monitor (1)\n- **`google-ads-anomaly-watch`** → polls every 15 min for CPA spikes \u003e20%, CTR drops \u003e15%, zero-conversion spend, budget-limited campaigns, disapproved ads\n\n---\n\n## Roadmap\n\n- v1.1 — 14 additional platform MCPs from [MiniAgent](https://github.com/itallstartedwithaidea/MiniAgent) (Meta, Microsoft, Amazon, LinkedIn, TikTok, Snap, Pinterest, Reddit, X, Spotify, TradeDesk, Criteo, AdRoll)\n- v1.2 — Writing Agent / Ghost Writer skills (18 platform formatters, AI-detection validation)\n- v1.3 — ContextOS cognitive primitives as built-in skills\n- v2.0 — LSP server for GAQL files, real-time campaign health dashboard\n\n---\n\n## Links\n\n- **Plugin source** — [github.com/itallstartedwithaidea/claude-googleadsagent](https://github.com/itallstartedwithaidea/claude-googleadsagent)\n- **Wiki + docs** — [github.com/itallstartedwithaidea/claude-googleadsagent/wiki](https://github.com/itallstartedwithaidea/claude-googleadsagent/wiki)\n- **Homepage** — [ahmeego.com](https://www.ahmeego.com)\n- **Hosted tools** — [ahmeego.com]([https://www.ahmeego.com/tools) — Buddy AI Agent, Auditor, Campaign Builder, Keyword Analyzer\n- **Author** — [@itallstartedwithaidea](https://github.com/itallstartedwithaidea) · [LinkedIn](https://www.linkedin.com/in/johnmichaelwilliams) · [Substack](https://itallstartedwithaidea.substack.com)\n\n---\n\n## License\n\nProprietary — © 2026 John Williams / Ahmeego. All Rights Reserved.\nSee [LICENSE](LICENSE). For commercial use beyond the runtime grant, contact `john@itallstartedwithaidea.com`.\n\n---\n\n\u003csub\u003eBuddy is a registered name of Ahmeego. Claude Code, Anthropic, and the Anthropic logo are trademarks of Anthropic, PBC. Google Ads, Performance Max, and related marks are trademarks of Google LLC. This plugin is not officially endorsed by Anthropic or Google.\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitallstartedwithaidea%2Fclaude-googleadsagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitallstartedwithaidea%2Fclaude-googleadsagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitallstartedwithaidea%2Fclaude-googleadsagent/lists"}