Google Ads Library MCP Server

Este es un servidor del Model Context Protocol (MCP) para el Google Ads Transparency Center.

Con él puedes buscar a cualquier empresa o marca en el Google Ads Transparency Center, ver lo que están publicando actualmente y analizar su publicidad. Puedes analizar imágenes y textos de anuncios, analizar anuncios de vídeo con información detallada, comparar las estrategias de las empresas y obtener datos sobre lo que está funcionando en sus campañas.

Aquí tienes un ejemplo de lo que puedes hacer cuando está conectado a Claude.

https://github.com/user-attachments/assets/a47aa689-e89d-4d4b-9df7-6eb3a81937ee

Versión alojada (Recomendada)

La forma más fácil de usar el Google Ads Library MCP es la versión alojada de Proxy (useproxy.dev). No necesitas claves de API, ni clave de Gemini, ni Python, ni un servidor que ejecutar: solo conéctate y empieza a hacer consultas.

• ⚡ Cero configuración — nada que instalar, configurar ni mantener

• 🔑 Sin claves de API — olvídate por completo de las claves de ScrapeCreators y Gemini

• 🔌 Funciona en todas partes — ChatGPT, Claude, Cursor, Manus y cualquier otro sitio compatible con MCP

• 🚀 Siempre actualizado — las nuevas herramientas y correcciones se publican automáticamente

👉 Empieza gratis en useproxy.dev →

¿Prefieres ejecutarlo tú mismo? La configuración completa de autoalojamiento está documentada más abajo.

Alojado vs. autoalojado

Para la mayoría de la gente, la versión alojada es la vía más rápida. Elige el autoalojamiento solo si quieres modificar o ampliar el servidor por tu cuenta.

Related MCP server: google-ads-transparency-mcp

Ejemplos de prompts

How many ads is 'AnthropicAI' running? What's their split across video and image?

What messaging is 'AnthropicAI' running right now in their ads?

Analyze the video ads from 'Nike' and extract their visual storytelling strategy, pacing, and brand messaging techniques.

Do a deep comparison to the messaging between 'AnthropicAI', 'Perplexity AI' and 'OpenAI'. Give it a nice forwardable summary.

Instalación

Requisitos previos

• Python 3.12+

• La aplicación Anthropic Claude Desktop (o Cursor)

• Pip (gestor de paquetes de Python), instala con python -m pip install

• Una clave de API de un proveedor de datos de anuncios, configurada como SCRAPECREATORS_API_KEY (consulta la configuración debajo)

• Una clave de API de Google Gemini para el análisis de vídeos (opcional, solo necesaria para anuncios de vídeo)

¿Prefieres no lidiar con claves de API? Consulta la Versión alojada más arriba para saltarte toda la configuración.

Instalación rápida (Recomendada)

1. Clona y ejecuta el script de instalación

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp
   
   # For macOS/Linux:
   ./install.sh
   
   # For Windows:
   install.bat

2. Configura tus claves de API

   Edita el archivo .env que se creó y añade tus claves de API:

   • Establece tu clave de API de datos de anuncios como SCRAPECREATORS_API_KEY

   • Obtén tu clave de API de Gemini en Google AI Studio (opcional, para el análisis de vídeo)

3. Sigue la configuración de MCP que se muestra

   El script de instalación te mostrará la configuración exacta que debes añadir a Claude Desktop o Cursor.

Instalación manual

Si prefieres instalarlo manualmente:

1. Clona este repositorio

   git clone https://github.com/proxy-intell/google-ads-library-mcp.git
   cd google-ads-library-mcp

2. Instala las dependencias

   pip install -r requirements.txt

3. Configura las claves de API

   Copia la plantilla y configura tus claves de API:

   cp .env.template .env
   # Then edit .env with your actual API keys

   Para obtener las claves de API:

   • Establece tu clave de API de datos de anuncios como SCRAPECREATORS_API_KEY en el archivo .env

   • Consigue una clave de API de Google Gemini aquí (opcional, para el análisis de vídeos)

4. Conecta el servidor MCP

   Añade la configuración del servidor MCP a la configuración de Claude Desktop o Cursor:

   {
     "mcpServers": {
       "google_ad_library": {
       "command": "/usr/local/opt/python@3.13/bin/python3",
         "args": [
           "{{PATH_TO_PROJECT}}/google-ads-library-mcp/mcp_server.py"
         ]
       }
     }
   }

   Reemplaza {{PATH_TO_PROJECT}} con la ruta completa donde clonetes este repositorio.

   Nota: Las claves de API se cargan automáticamente desde el archivo .env. Los argumentos de línea de comandos siguen siendo compatibles y tienen prioridad sobre las variables de entorno si se proporcionan.

   Para Claude Desktop:

   Guarda esto como claude_desktop_config.json en el directorio de configuración de Claude Desktop, en:

   ~/Library/Application Support/Claude/claude_desktop_config.json

   Para Cursor:

   Guarda esto como mcp.json en el directorio de configuración de Cursor, en:

   ~/.cursor/mcp.json

5. Reinicia Claude Desktop / Cursor

   Abre Claude Desktop y ahora deberías ver Google Ads Library como una integración disponible.

   O reinicia Cursor.

Detalles técnicos

1. Claude envía las solicitudes al servidor MCP de Python

2. El servidor MCP consulta la API de datos de anuncios para obtener datos del Google Ads Transparency Center

3. Los datos vuelven por la cadena hasta Claude

Google Ads

Este servidor se conecta al Google Ads Transparency Center:

• Google Ads: Utiliza el dominio de la empresa (p. ej., "nike.com") o el ID de anunciante para buscar

• Formato de respuesta: Devuelve anuncios con tipos de formato (texto/imagen/vídeo) y variaciones detalladas

• Detalles del anuncio: Cada anuncio puede tener múltiples variaciones con diferentes titulares y descripciones

• Datos regionales: Incluye estadísticas específicas de la región y datos de impresiones

Consejos:

• Utiliza dominios de empresas (p. ej., "nike.com") en lugar de nombres de marca para buscar

• Ahora se admiten anuncios de texto además de anuncios de imagen y vídeo

• Cada anuncio puede tener varias variaciones con diferentes titulares e descripciones

Herramientas MCP disponibles

Este servidor MCP proporciona herramientas para interactuar con objetos del Google Ads Transparency Center:

Solución de problemas

Problemas frecuentes

Error: no se encuentra la clave de API:

• Asegúrate de que el archivo .env esté en la raíz del proyecto

• Si no tienes un archivo .env, cópia el de la plantilla: cp .env.template .env

• Comprueba que tus claves de API tienen el formato correcto, sin comillas

• Verifica que el archivo .env contoco SCRAPECREATORS_API_KEY=your_key_here

• Para el análisis de vídeos, asegúrate de añadir también GEMINI_API_KEY=your_key_here

El análisis de vídeos no funciona:

• Confirma que tienes una clave de API válida de Google Gemini en tu archivo .env

• El análisis de video requiere la variable de entorno GCORE_API_KEY

Problemas de about the conexión del servidor MCP:

• Verifica que la ruta en tu configuración MCP apunte a la ubicación correcta

• Asegúrate de haber instalado todas las dependencias con pip install -r requirements.txt

• Reinicia Claude Desktop/Cursor después de los cambios de configuración

Para obtener más ayuda con la integración de Claude Desktop, consulta the Nueva documentación de MCP en documentación de MCP. La documentación incluye sugerencias curiosantes para revisar los registros and solucionar problemas comunes.

Notas específicas de Google Ads:

• Utiliza dominios de empresas (p. ej., "nike.com") en lugar de nombres de sues para buscar

• Ahora también se admiten anuncios de texto, además de los anuncios de imagen y vídeo

• Cada anuncio puede tener varios variaciones con textos y descripciones differententes

Preguntas frecuentes

¿Cuál es la manera más sencilla de usar el Google Ads Library MCP? La manera más sencilla es la versión alojada de Proxy (useproxy.dev). No requiere claves de API, ni instalación, ni servidor: lo conectas a ChatGPT, Claude, Cursor o a cualquier cliente MCP y empiezas a consultar inmediatamente. Puedes empezember gratis.

¿Necesito una clave de API para usar este MCP? Solo si lo auto- tiras. La versión alojada en useproxy.dev gestiona todo el acceso a los datos, por lo que no necesitas claves de ScrapeCreators ni de Gemini. El autoalojamiento requiere una SCRAPECREATORS_API_KEY (y una clave de Gemini para el análisis de vídeos).

¿Con qué clientes de MCP funciona? Both the hosted and self-hosted version. ¿ English? Use prompt in English: "Which MCP clients does it work with?" the answer: Tanto la versión alojada como la autoalojada funcionan con ChatGPT, Claude (escritorio y web), Cursor, Manus y cualquier otro cliente compatible con el Model Context Protocol.

¿Hay una versión gratuita? Sí — la versión alojada de proxy ofrece un plan gratuito para que puedas empezar a analizzare anunci sans ningún setup.

¿Debo autoalojar la versión completa o usar la versión alojora? Usa la versión alojada si solo quieres acceso rápido y fiable a los datos de Google Ads Transparency Center con zero mantenimiento; esto se adapta a la mayoría de usuarios. Auto-aloja solo si quieres modificar o ensanchar el servidor tú mismo.

Feedback

We will be very appreciative your feedback. Please tell us what features from that list you would like to see next, or ask for entirely new ones.

Actually need translate text. Let's do correctly.

---

## Comentarios

Apreciamos mucho tu feedback. Por favor [cuéntanos](mailto:support@useproxy.dev) qué funciones de esa lista te gustaría que sean las siguientes o solicita una completamente nuevas.

***

## Licencia

Este proyecto está bajo la Licencia MIT.

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Python](https://img.shields.io/badge/python-3.12+-green.svg)

***

Hecho con ❤️ por el equipo de [Proxy](https://useproxy.dev/).