convez.ai
MCP ServerMarketing & VendasAvançado
itallstartedwithaidea

Google Ads Agent — Buddy

itallstartedwithaidea/claude-googleadsagent

Automação enterprise de Google Ads com 6 sub-agentes, 77 skills e monitoramento anômalo

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server e plugin Claude para automação completa de Google Ads com 6 sub-agentes especializados (Simba, Nemo, Elsa, Aladdin, Moana, Baymax), 77 skills de produção e monitoramento anômalo em tempo real. Integra API do Google Ads com validação GAQL e hooks de segurança para operações de leitura/escrita controladas.

Instalação

$npx convez-ai itallstartedwithaidea/claude-googleadsagent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
2
Acompanhando
2
Saúde
71%
Último commit
há 4 meses
Versão
v1.0.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Automação de campanhas Google Ads em escala enterprise
  • Auditoria e otimização de desempenho com análise anômala em tempo real
  • Pesquisa competitiva e geração criativa de anúncios com IA
  • Relatórios e insights sobre CPA, CTR e ROI de campanhas

Veredito

Ferramenta robusta e bem-arquitetada para agências e empresas com gestão complexa de Google Ads. Demanda setup OAuth e conhecimento técnico significativo, mas oferece automação, monitoramento e otimização genuinamente enterprise.

README

A tradução para o português deste README ainda está na fila.

Google Ads Agent — Buddy

The most comprehensive Google Ads + advertising automation plugin for Claude Code. By Ahmeego · itallstartedwithaidea · powered by Buddy

PyPI npm Claude Code Plugin License: Proprietary


What you get

  • Buddy — flagship Opus-powered Google Ads enterprise agent with live API access
  • 6 specialized sub-agents (Simba, Nemo, Elsa, Aladdin, Moana, Baymax) covering reporting, research, optimization, Shopping/PMax, creative, and creative-innovate
  • 2 MCP servers — googleadsagent-mcp (Google Ads API) and @googleadsagent/ad-creative-mcp (Cloudinary-backed creative validation)
  • ~77 production skills across Google Ads, AI agent engineering, Claude mythos, software dev, security, infrastructure, productivity, web frontend, scientific research, and media creative
  • 7 slash commands — /analyze, /audit, /optimize, /status, /login, /logout, /switch
  • Safety hooks — PreToolUse GAQL validation prevents write operations from read-only contexts, PostToolUse audit logging
  • Background anomaly monitor — surfaces CPA spikes, CTR drops, and zero-conversion spend in real time
  • Buddy as the default agent — settings.json activates Buddy immediately on plugin load

Built by a practitioner with $350M+ in managed ad spend across Google, Meta, Microsoft, and Amazon. Reference architecture is the production system behind ahmeego.com.


Install (one command)

Once the plugin is approved in Anthropic's community marketplace:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install googleadsagent@claude-community

Self-hosted install (available immediately)

/plugin marketplace add itallstartedwithaidea/claude-googleadsagent
/plugin install googleadsagent@claude-googleadsagent

Local dev install

git clone https://github.com/itallstartedwithaidea/claude-googleadsagent
claude --plugin-dir ./claude-googleadsagent

Authentication

The Google Ads MCP server needs OAuth credentials. Copy .env.example to .env and fill in:

VariableWhere to get it
GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads → Tools → API Center
GOOGLE_ADS_CLIENT_IDGoogle Cloud Console → OAuth 2.0 Client IDs
GOOGLE_ADS_CLIENT_SECRETSame as above
GOOGLE_ADS_REFRESH_TOKENRun claude-googleadsagent oauth (see wiki)
GOOGLE_ADS_LOGIN_CUSTOMER_IDYour MCC account ID (no dashes)

Full walkthrough: Wiki → Authentication Or use the Ahmeego hosted OAuth flow: ahmeego.com/docs/google-ads-auth


Quick start

Inside Claude Code after installing the plugin:

# Talk to Buddy directly
> Hey Buddy, audit my Google Ads account 1234567890 for the last 30 days

# Run a slash command
/googleadsagent:audit My MCC, last 30 days, focus on PMax campaigns

# Invoke a sub-agent explicitly
> @simba pull a search-term waste report for campaigns with >$50 spend and zero conversions
> @aladdin which Shopping product groups are limited by budget?
> @baymax resize these display creatives for all standard IAB sizes

# Use a specific skill
/googleadsagent:keyword-research expand my "personal injury lawyer" keyword list with high-intent variants

What's in the box

Agents (7)

AgentRole
BuddyFlagship Google Ads strategist — orchestrates everything
SimbaReporting & analysis
NemoResearch & competitive intelligence
ElsaBulk optimization & write ops
AladdinShopping & Performance Max
MoanaVisual ad creative (RDA, Demand Gen)
BaymaxCreative resizing & format conversion

MCP servers (2)

ServerSourcePowers
google-adsgoogleadsagent-mcp (PyPI)Live Google Ads API — read, analyze, create, modify
ad-creativeBundled in servers/ad-creative-mcp/server.mjs (455KB, deps inlined) — also published as @googleadsagent/ad-creative-mcp on npmCloudinary-backed creative validation, resizing, optimization

Skill categories (77 skills)

  • 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
  • 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
  • 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
  • Software Dev (8) — code-review, test-driven-development, systematic-debugging, git-worktrees, brainstorming, subagent-driven-development, writing-plans, executing-plans
  • Security (4) — agent-security-scanning, codeql-semgrep, sandbox-hardening, secret-protection
  • Infrastructure (6) — cloudflare-workers, ci-cd-pipelines, edge-rendering, observability, service-discovery, configuration-management
  • Productivity (6) — workflow-orchestration, batch-processing, knowledge-base-rag, ai-chat-studio, low-code-generation, assistant-presets
  • Web Frontend (6) — react-best-practices, react-native-guidelines, view-transitions, edge-deployment, composition-patterns, web-design-guidelines
  • Scientific Research (8) — data-analysis, machine-learning, bioinformatics, cheminformatics, geospatial-analysis, research-methodology, scientific-writing, database-lookup
  • Media Creative (3) — web-asset-generation, programmatic-video, ml-model-integration

Slash commands (7)

/analyze · /audit · /optimize · /status · /login · /logout · /switch

Hooks (2)

  • PreToolUse → validates GAQL queries before execution to block accidental writes from read-only contexts
  • PostToolUse → logs every Google Ads tool call to an audit trail

Background monitor (1)

  • google-ads-anomaly-watch → polls every 15 min for CPA spikes >20%, CTR drops >15%, zero-conversion spend, budget-limited campaigns, disapproved ads

Roadmap

  • v1.1 — 14 additional platform MCPs from MiniAgent (Meta, Microsoft, Amazon, LinkedIn, TikTok, Snap, Pinterest, Reddit, X, Spotify, TradeDesk, Criteo, AdRoll)
  • v1.2 — Writing Agent / Ghost Writer skills (18 platform formatters, AI-detection validation)
  • v1.3 — ContextOS cognitive primitives as built-in skills
  • v2.0 — LSP server for GAQL files, real-time campaign health dashboard

Links


License

Proprietary — © 2026 John Williams / Ahmeego. All Rights Reserved. See LICENSE. For commercial use beyond the runtime grant, contact john@itallstartedwithaidea.com.


Buddy 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.

Ver o original no GitHub

Bom para

Relacionados