Vibe Ads

Gestor de Google Ads impulsado por IA para negocios de servicios locales. 37 categorías. Configuración en 5 minutos. $20/mes.

GitHub

Documentación

@vibeads/mcp

Habla con tu cuenta de Google Ads desde Claude Desktop, Cursor o cualquier cliente MCP.

Diseñado para negocios de servicios locales: 35 categorías, 32 de ellas con palabras clave ajustadas, referencias de CPC y plantillas de embudo.

El servidor oficial de Model Context Protocol para VibeAds. Pregúntale a Claude cosas como "¿qué términos de búsqueda están desperdiciando mi presupuesto?" o "¿cuál es mi puntaje de salud de la cuenta?" y obtén respuestas extraídas de los datos en vivo de tus campañas.

A diferencia de los servidores MCP genéricos de Google Ads, este está preajustado para negocios de servicios locales y agrupa más de 35 reglas de diagnóstico en un único puntaje de salud de cuenta de 0 a 100 en 6 dimensiones. En los planes Pro/Max también puede redactar estrategias de campaña, ejecutar optimizaciones con salvaguardas, añadir grupos de anuncios e iniciar flujos de publicación, siempre con la aprobación humana para cualquier acción que implique gasto de dinero.

Características

🎯 Prioridad a servicios locales — 27 verticales de servicios para el hogar más 8 profesionales/generación de leads; 32 de ellas tienen sus propias semillas de palabras clave, referencias de CPC, segmentos de audiencia y plantilla de embudo
📊 Puntaje de salud de cuenta 0-100 — ponderado en 6 dimensiones (Seguimiento, Palabras clave, Presupuesto, Creatividad, Segmentación, Rendimiento)
🔍 Detección de desperdicio en términos de búsqueda — encuentra cada dólar que se quema en términos sin conversiones
💡 Resumen de diagnósticos — más de 35 reglas del motor de optimización de VibeAds, clasificadas por severidad
✍️ Herramientas de escritura (Pro/Max) — redacta estrategias, aprueba optimizaciones e inicia flujos de publicación a través de la puerta de enlace de VibeAds
🔒 Seguro por diseño — las herramientas de lectura no pueden modificar nada; las herramientas de escritura operan dentro de las salvaguardas de seguridad de VibeAds, y la publicación siempre requiere aprobación humana en el navegador
⚡ Sin necesidad de GAQL — haz preguntas en lenguaje natural y obtén respuestas en markdown

Categorías compatibles

Servicios locales y para el hogar (27): plomero · HVAC · electricista · techador · limpiador · paisajista · control de plagas · pintor · manitas · cerrajero · puerta de garaje · reparación de electrodomésticos · servicio de árboles · cercas · ventanas y puertas · alfombras y pisos · impermeabilización · lavado a presión · limpieza de conductos de aire y secadoras · limpieza comercial y conserjería · servicios de piscinas · retiro de chatarra · mudanzas · reparación de autos · iluminación navideña · dentista · abogado

Profesionales y generación de leads (8): bienes raíces · seguros · servicios financieros · educación · salud · consultoría · SaaS · servicios B2B

La consultoría, SaaS y los servicios B2B usan valores predeterminados genéricos, al igual que cualquier otra categoría que pases, en lugar de una base de conocimiento ajustada.

Instalación

¿Usas ChatGPT, Claude o Meta AI? No necesitas este paquete ni una clave: añade el servidor alojado, https://getvibeads.com/api/mcp, en el asistente e inicia sesión en VibeAds cuando lo pida. Pasos para cada asistente: Conectar ChatGPT, Claude o Meta AI. Este paquete es para clientes que ejecutan herramientas en tu computadora, como Claude Code, Cursor y Cline.

Paso 1 — Obtén tu clave de API

Inicia sesión en tu cuenta de VibeAds y genera una clave de API:

→ Generar clave de API

Las claves comienzan con vba_mcp_ y están limitadas solo a tu cuenta.

Paso 2 — Configura tu cliente MCP

Claude Desktop

Abre tu archivo de configuración:

Sistema operativo	Ruta
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Añade esto al bloque mcpServers:

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": ["-y", "@vibeads/mcp"],
      "env": {
        "VIBEADS_API_KEY": "vba_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver las herramientas de VibeAds aparecer en el menú de herramientas 🔨.

Cursor

Abre Configuración → MCP
Haz clic en Añadir servidor
Configura:
- Nombre: vibeads
- Comando: npx -y @vibeads/mcp
- Variables de entorno: VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE

Cline / Claude Code / otros clientes MCP

Usa la misma configuración que Claude Desktop arriba. La mayoría de los clientes MCP siguen el mismo esquema.

Variables de entorno

La configuración es una sola variable de entorno: cada herramienta (de lectura y escritura) se ejecuta a través de la puerta de enlace segura de VibeAds en el servidor con tu clave de API.

Variable	¿Obligatoria?	Propósito
`VIBEADS_API_KEY`	✅ Obligatoria	Tu clave de `vba_mcp_...`. Es la única credencial que necesita cualquier herramienta.
`VIBEADS_SUPABASE_URL`	Opcional	Sobrescribe la URL del backend de VibeAds. El valor predeterminado es el endpoint de producción.

Uso

Una vez configurado, puedes hacer preguntas a Claude como:

📋 Descubrimiento de campañas

"Muéstrame todas mis campañas de VibeAds"

"¿Qué campañas están en pausa?"

"Dame las 5 campañas creadas más recientemente"

🔬 Análisis en profundidad

"Cuéntame todo sobre mi campaña de plomero en Austin"

"¿Cómo rindió mi campaña de HVAC la semana pasada?"

"¿Cuál es el CPA de la campaña abc12345?"

📈 Informes para cualquier período

"Compara septiembre con agosto para mi campaña de plomería en Austin"

"Gasto por dispositivo en toda mi cuenta el mes pasado"

"¿Qué palabras clave gastaron más en los últimos 90 días?"

🔎 Investigación de palabras clave

"¿Cuántas personas buscan limpieza de desagües en Austin, TX?"

"Encuentra ideas de palabras clave desde mi página de servicios para Round Rock y Pflugerville"

🧾 Auditoría de una cuenta completa de Google Ads

Funciona justo después de conectar Google Ads, antes de importar cualquier cosa:

"¿Dónde se está desperdiciando mi presupuesto de Google Ads?"

"Audita mi cuenta de Google Ads"

📊 Salud de la cuenta

"¿Cuál es mi puntaje de salud de la cuenta de VibeAds?"

"¿Qué dimensión está bajando mi puntaje?"

"Dame el puntaje de salud solo para la campaña xyz"

💸 Análisis de términos de búsqueda

"¿Qué términos de búsqueda están desperdiciando mi presupuesto?"

"Muéstrame las 10 mejores palabras clave ganadoras de los últimos 30 días"

"¿Cuánto estoy gastando en términos con cero conversiones?"

🩺 Diagnósticos y recomendaciones

"¿Qué debería arreglar primero?"

"Muéstrame todos los diagnósticos críticos"

"¿Qué le pasa a mi campaña de techado?"

Herramientas disponibles

Herramientas de lectura

Herramienta	Propósito
`list_campaigns`	Tus campañas en VibeAds (publicadas, importadas y borradores) con estado, presupuesto y categoría. Las campañas que solo están en tu cuenta de Google Ads se listan mediante `find_campaigns_to_import`
`get_campaign_details`	Análisis en profundidad de una campaña: métricas, grupos de anuncios, segmentación, páginas de destino, diagnósticos
`get_account_health_score`	Puntaje de 0-100 + calificación con letra en 6 dimensiones, opcionalmente por campaña
`get_search_term_analysis`	Gasto desperdiciado + ganadores de los términos de búsqueda sincronizados más recientes de cada campaña, que cubren los 7 días anteriores a esa sincronización (umbral de costo configurable)
`get_diagnostics`	Diagnósticos más recientes de optimización del agente con severidad + corrección recomendada (hasta 50)
`find_campaigns_to_import`	Antes de importar: las campañas en tu cuenta de Google Ads, leídas desde Google Ads, cada una marcada con si está en VibeAds (VibeAds gestiona solo las campañas que contiene). Se llama `list_google_ads_campaigns` en 0.2.15
`get_performance_report`	Cifras de una campaña o de toda la cuenta para un período que elijas (un valor predefinido o dos fechas, hasta 90 días), leídas en vivo desde Google Ads, opcionalmente por día, dispositivo, hora, grupo de anuncios, palabra clave o ubicación. Dinero en la moneda de la cuenta. VibeAds construye cada consulta; el asistente solo elige el período y el desglose
`audit_google_ads_account`	Una auditoría de una cuenta conectada de Google Ads, leída en vivo desde Google Ads: hasta 25 campañas de Búsqueda en los últimos 30 días, estén o no en VibeAds, con un puntaje de salud de 0-100 y calificación para la cuenta y cada campaña, los problemas agrupados por verificación con qué los corrige en Google Ads, y los términos de búsqueda más costosos de cada campaña con clics y sin conversiones. Se guarda una auditoría por cuenta durante 24 horas
`list_keywords`	Los grupos de anuncios, palabras clave y palabras clave negativas de una campaña publicada, leídos en vivo desde Google Ads: tipo de concordancia, estado, CPC máximo y 30 días de clics, costo y conversiones
`research_keywords`	Ideas de palabras clave del Planificador de palabras clave de Google para palabras clave semilla, una página web o ambas, en los lugares que nombres: búsquedas mensuales promedio, competencia y rango de oferta de parte superior de página. Pro/Max, 2 créditos (una repetición dentro de 90 días es gratuita)
`list_google_ads_accounts`	Cada cuenta conectada de Google Ads, activada o no, con la cuenta de administrador (MCC) bajo la que se encuentra cada cuenta de cliente
`list_google_recommendations`	Las propias recomendaciones de Google para una cuenta (su página de Recomendaciones), con la estimación de Google y si cada una se puede aplicar desde el chat

Las herramientas de lectura son de solo lectura: no pueden crear, modificar, pausar ni eliminar nada en tu cuenta de Google Ads. Se ejecutan en el servidor a través de la puerta de enlace de VibeAds y solo necesitan VIBEADS_API_KEY. Las herramientas de lectura funcionan en cualquier plan, incluido el gratuito, excepto research_keywords, que requiere Pro o Max.

Herramientas de escritura (Pro/Max)

Las herramientas de escritura se comunican con la puerta de enlace segura de VibeAds en el servidor y necesitan solo VIBEADS_API_KEY — sin claves de Supabase. Cada llamada tiene límite de velocidad por clave, las optimizaciones aprobadas se miden después (los cambios más pequeños se revierten automáticamente si las métricas empeoran), y la publicación siempre requiere aprobación humana en el navegador. La clave de API por sí sola nunca puede gastar dinero.

Herramienta	Propósito
`generate_strategy`	Redactar una estrategia completa de campaña (palabras clave, textos de anuncios, 3+ grupos de anuncios) en el servidor, con un grupo de anuncios de Marca para búsquedas del nombre de tu negocio, y en Max un grupo de anuncios para cada competidor que nombres. Cuesta 13 créditos. Solo borrador: no se publica nada, no se gasta dinero
`get_strategy_status`	Consultar un trabajo de estrategia: estado, fase y grupos de anuncios redactados una vez completado
`apply_strategy`	Convertir una vista previa completada en una campaña de borrador real (grupos de anuncios, palabras clave, segmentación, textos de anuncios, extensiones). Cuesta 6 créditos + 3 por grupo de anuncios para generación de imágenes. Solo borrador — no está en vivo, no se gasta dinero en anuncios
`list_recommendations`	Recomendaciones de optimización pendientes, cada una con la herramienta y los argumentos exactos que la ejecutan (con sus IDs de sesión y recomendación), o un enlace para aprobarla en VibeAds cuando ninguna herramienta realiza ese cambio
`preview_ad_group`	Mostrar un nuevo grupo de anuncios (palabras clave, tres anuncios, plan de página de destino) antes de añadirlo. Crea solo una vista previa
`add_ad_group`	Añadir un grupo de anuncios con vista previa. En una campaña publicada, comienza a mostrarse de inmediato, dentro del presupuesto de la campaña
`request_publish`	Iniciar el flujo de publicación para una campaña que tiene grupos de anuncios — devuelve una URL de aprobación humana porque publicar gasta dinero real. Con más de una cuenta de Google Ads, pregunta cuál y publica solo en esa
`import_campaigns`	Traer hasta 3 campañas de tu cuenta de Google Ads a VibeAds, para que su optimizador e informes las cubran. No cambia nada en Google Ads. 1 crédito cada una
`pause_campaign`	Pausar una campaña activa en Google Ads
`resume_campaign`	Reanudar una campaña en pausa. Reanudar gasta dinero, así que con una clave de API devuelve una URL de aprobación humana, como al publicar
`add_negative_keywords`	Añadir hasta 20 palabras clave negativas a una campaña o a un grupo de anuncios, de una vez. Una que bloquearía las propias palabras clave de la campaña se omite
`add_keywords`	Añadir hasta 20 palabras clave a un grupo de anuncios, de una vez, al CPC máximo predeterminado del grupo de anuncios
`set_keyword_status`	Pausar palabras clave, o reactivar las que están en pausa
`set_max_cpc`	Establecer el CPC máximo de un grupo de anuncios, una palabra clave o una lista de palabras clave en una campaña de CPC manual. Hasta el doble y $50 por clic de una vez; más devuelve una URL de aprobación
`set_daily_budget`	Establecer el presupuesto diario de una campaña. Una disminución se ejecuta de inmediato; con una clave de API, cualquier aumento devuelve una URL de aprobación
`dismiss_google_recommendation`	Eliminar una de las recomendaciones de Google de su lista. Sin cambios en la campaña
`check_approval`	Consultar una publicación o aprobación de cambio: pendiente → aprobado → ejecutando → ejecutado (o rechazado / expirado / fallido)

Cada cambio de palabra clave, oferta, presupuesto y reactivación se lista en la pestaña Optimizar de la campaña en VibeAds, donde se puede deshacer. VibeAds nunca revierte estos cambios por sí mismo. Un asistente puede hacer 20 cambios a una campaña al día.

De la idea a la campaña en vivo:

generate_strategy redacta la estrategia en el servidor y devuelve un jobId. Todavía no existe nada en Google Ads.
get_strategy_status consulta ese trabajo hasta que informe completed.
apply_strategy convierte la vista previa terminada en una campaña borrador real y devuelve un campaignId. Sigue sin estar activa y sin gastar nada.
request_publish toma ese campaignId y devuelve un enlace de aprobación.
Abres el enlace en tu navegador, revisas la campaña y el presupuesto, y haces clic en Aprobar (o Rechazar).
check_approval informa la aprobación y luego el trabajo de publicación; la campaña se activa una vez que ese trabajo se completa.

Los pasos 1–3 crean filas solo en VibeAds y gastan créditos de VibeAds (13 para el paso 1; 6 + 3 por grupo de anuncios para el paso 3). El paso 5 es el único punto donde se compromete dinero de anuncios, y solo puede ocurrir en un navegador — la clave de API por sí sola nunca puede publicar.

Los asistentes que conectas iniciando sesión en VibeAds en lugar de con una clave (como ChatGPT o claude.ai, a través del servidor alojado en https://getvibeads.com/api/mcp) pueden publicar una campaña de Búsqueda sin el enlace cuando lo permites hasta un presupuesto diario, en Configuración de VibeAds bajo Aplicaciones conectadas. Ellos confirman el presupuesto diario de cada campaña contigo primero. Las claves de API nunca pueden hacerlo, por lo que una clave filtrada tampoco puede gastar.

Seguridad

Las herramientas de lectura son de solo lectura. No pueden modificar tus campañas, tu cuenta de Google Ads ni tu configuración de VibeAds.
Las herramientas de escritura están protegidas. Cada acción de escritura se ejecuta en el servidor a través de la puerta de enlace de VibeAds, con límite de velocidad por clave. Las optimizaciones aprobadas se miden después; los cambios más pequeños se revierten automáticamente si las métricas empeoran, y la publicación siempre requiere que un humano apruebe en el navegador. La clave de API nunca puede aprobar el gasto publicitario por sí sola.
Las claves se almacenan con hash SHA-256 antes de guardarse. La clave completa solo se muestra una vez al crearla.
Revocable en cualquier momento desde https://getvibeads.com/app/settings/mcp.
El uso se registra por clave: marca de tiempo del último uso y recuento de solicitudes.
Aislamiento a nivel de fila — cada clave está vinculada a un único usuario de VibeAds. Las claves no pueden ver los datos de otros usuarios.
Caducidad opcional — establece fechas de expiración en las claves para cuentas de servicio / acceso temporal.

Para máxima seguridad, rota tu clave de API cada vez que un dispositivo cambie de manos o una colaboración termine.

Requisitos

Node.js ≥ 20 (para el runtime npx)
Cuenta activa de VibeAds: el plan gratuito es suficiente para generar una clave
Plan Pro o Max: necesario para las herramientas de escritura (las herramientas de lectura funcionan en cualquier plan)
Al menos una campaña publicada: los diagnósticos necesitan datos sincronizados de Google Ads

Comparativa

	VibeAds MCP	GoMarble MCP	Google Ads MCP (oficial)
Tiempo de configuración	2 min	15 min	30 min
OAuth requerido	❌ (solo clave de API)	✅	✅
Conocimiento de GAQL requerido	❌	✅	✅
Ajuste de servicio local	✅	❌	❌
Puntuación de salud de cuenta	✅ 6 dimensiones	❌	❌
Diagnósticos predefinidos	✅ 35+ reglas	❌	❌
Multi-cuenta	✅	✅	✅
Acciones de escritura protegidas	✅ publicación aprobada por humano	❌	❌

Cuándo usar VibeAds MCP: Diriges un negocio de servicios local (o gestionas anuncios para uno) y quieres información preajustada sin aprender GAQL.

Cuándo usar GoMarble / Google Ads MCP: Necesitas ejecutar consultas GAQL personalizadas o trabajar con campañas que no son de servicios (comercio electrónico, B2B SaaS, etc.).

Los tres pueden coexistir: instala los que se adapten a tu flujo de trabajo.

Solución de problemas

"Error de autenticación"

Asegúrate de que tu clave comience con vba_mcp_
Genera una nueva clave en https://getvibeads.com/app/settings/mcp
Verifica que la clave no haya sido revocada o expirada

"Sin diagnósticos de optimizador todavía"

Los diagnósticos se generan cada 12 horas por el agente de VibeAds, una vez que el rendimiento de Google Ads se ha sincronizado. Si acabas de publicar una campaña, espera hasta un día para la primera ejecución.

"No se encontraron datos de términos de búsqueda"

La sincronización de términos de búsqueda se ejecuta cada 6 horas. Para campañas nuevas, espera 24-48 horas para que se acumulen datos significativos.

El cliente MCP no puede encontrar el servidor

Asegúrate de tener Node.js 20+ instalado: node --version. Claude Desktop y Cursor ambos invocan npx, por lo que Node debe estar en tu PATH.

Contribuciones

Este es un paquete de código abierto con licencia MIT. Los problemas y solicitudes de extracción son bienvenidos en: https://github.com/vibeads/mcp/issues