Google Ads MCP Server

Servidor MCP para optimización de campañas de Google Ads orientado a equipos de growth marketing.

🚀 Características

Herramientas Disponibles

📊 Análisis de Campañas

• campaign_performance - Analiza rendimiento con métricas clave y ROI
• campaign_optimization_opportunities - Encuentra oportunidades de optimización

🔍 Gestión de Keywords

• keyword_performance - Analiza rendimiento de keywords y encuentra oportunidades
• negative_keyword_suggestions - Keywords que deberías añadir como negativos
• keyword_opportunities - Descubre nuevas keywords rentables

💰 Análisis de ROI

• growth_pulse - Dashboard ejecutivo con KPIs principales
• conversion_path_analysis - Analiza customer journey y puntos de conversión
• roi_deep_dive - Análisis profundo de ROI por segmento

💰 Optimización de Presupuesto

• budget_optimizer - Optimiza distribución entre campañas
• budget_forecast - Proyecta resultados futuros por escenario
• smart_bidding_recommendations - Recomienda estrategias de Smart Bidding

📦 Instalación

npx @weppa-cloud/mcp-google-ads

⚙️ Configuración

Paso 1: Credenciales de Google Ads

1. Ve a Google Cloud Console
2. Crea un proyecto nuevo o usa uno existente
3. Habilita la Google Ads API
4. Crea credenciales OAuth 2.0 para aplicación de escritorio
5. Solicita tu Developer Token en Google Ads

Paso 2: Configurar Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["@weppa-cloud/mcp-google-ads"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "tu-client-id.apps.googleusercontent.com",
        "GOOGLE_ADS_CLIENT_SECRET": "tu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "uzJARNmmqM3TJbSBBJm3CQ",
        "GOOGLE_ADS_CUSTOMER_ID": "123-456-7890",
        "GOOGLE_ADS_REFRESH_TOKEN": "tu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "987-654-3210"
      }
    }
  }
}

Paso 3: Obtener Refresh Token

1. Usa el OAuth 2.0 Playground o genera el URL de autorización
2. Autoriza tu aplicación
3. Intercambia el código por el refresh token

🎯 Casos de Uso

Análisis Diario

"¿Cómo van mis campañas esta semana?"
"Dame el growth pulse"
"¿Qué campañas tienen bajo ROAS?"

Optimización de Keywords

"¿Qué keywords debería pausar?"
"Encuentra oportunidades de keywords"
"Sugiere keywords negativos para la campaña X"

Gestión de Presupuesto

"Optimiza mi distribución de presupuesto"
"¿Cómo se vería un aumento del 20% de presupuesto?"
"¿Qué campañas deberían usar Smart Bidding?"

⚠️ Limitaciones

• Acceso Básico: Solo operaciones de lectura/análisis
• Sin modificaciones: No puede cambiar pujas, presupuestos o configuraciones
• Rate Limits: Respeta límites de la API de Google Ads

🔧 Variables de Entorno

| Variable | Requerida | Descripción | |----------|-----------|-------------| | GOOGLE_ADS_CLIENT_ID | ✅ | Client ID OAuth2 | | GOOGLE_ADS_CLIENT_SECRET | ✅ | Client Secret OAuth2 | | GOOGLE_ADS_DEVELOPER_TOKEN | ✅ | Token de desarrollador | | GOOGLE_ADS_CUSTOMER_ID | ✅ | ID de cuenta de Google Ads | | GOOGLE_ADS_REFRESH_TOKEN | ✅ | Refresh token OAuth2 | | GOOGLE_ADS_LOGIN_CUSTOMER_ID | ❌ | Para cuentas de manager |

🐛 Troubleshooting

Error: "Invalid developer token"

• Verifica que el token esté activo
• Para test, usa el token de prueba: uzJARNmmqM3TJbSBBJm3CQ

Error: "Customer not found"

• Verifica el formato del customer ID (123-456-7890)
• Asegúrate de tener acceso a la cuenta

Error: "Refresh token invalid"

• Regenera el refresh token
• Verifica que tengas scope https://www.googleapis.com/auth/adwords

📚 Recursos

• Google Ads API Documentation
• OAuth 2.0 Setup Guide
• Developer Token Guide

🤝 Soporte

¿Problemas? Abre un issue en GitHub

Desarrollado por el equipo Growth de Weppa Cloud