@weppa-cloud/mcp-google-ads/README.md

Google Ads MCP server for growth marketing - campaign optimization, keyword research, and ROI tracking

# 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

```bash
npx @weppa-cloud/mcp-google-ads
```

## ⚙️ Configuración

### Paso 1: Credenciales de Google Ads

1. Ve a [Google Cloud Console](https://console.cloud.google.com/)
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`:

```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](https://developers.google.com/google-ads/api)
- [OAuth 2.0 Setup Guide](https://developers.google.com/google-ads/api/docs/oauth/overview)
- [Developer Token Guide](https://developers.google.com/google-ads/api/docs/first-call/dev-token)

## 🤝 Soporte

¿Problemas? Abre un issue en [GitHub](https://github.com/weppa-cloud/mcp-tools/issues)

---

**Desarrollado por el equipo Growth de Weppa Cloud**