Google AdsLibrary MCP Server

Это сервер Model Context Protocol (MCP) для Google Ads Transparency Center.

С помощью этого сервера можно искать в публичном рекламном центре Google любую компанию или бренд, смотреть, что они сейчас показывают, и анализировать их рекламу. Можно анализировать изображения и тексты объявлений, получать подробные результаты по видеорекламе, сравнивать стратегии компаний и находить инсайты о том, что работает в их кампаниях.

Вот пример того, что можно делать, когда сервер подключён к Claude.

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

Хостинговая версия (рекомендуется)

Самый простой способ использовать Google Ads Library MCP — это хостинговая версия от Proxy (useproxy.dev). Никаких API-ключей, ключа Gemini, Python или сервера для запуска — просто подключайтесь и начинайте делать запросы.

• ⚡ Никакой настройки — не нужно ничего устанавливать, настраивать или поддерживать

• 🔑 Никаких API-ключей — обходитесь без ключей ScrapeCreators и Gemini

• 🔌 Работает везде — ChatGPT, Claude, Cursor, Manus и любое другое место с поддержкой MCP

• 🚀 Всегда актуально — новые инструменты и возможности появляются автоматически

👉 Начните бесплатно на useproxy.dev →

Предпочитаете запускать сами? Полная инструкция по самостоятельному развёртыванию приведена ниже.

Хостинговая версия против Self-Host

Для большинства людей хостинговая версия — самый быстрый способ. Выбирайте самостоятельное развёртывание, если хотите модифицировать или расширять сервер самостоятельно.

Related MCP server: Facebook Ads Library MCP Server

Примеры промптов

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.

Установка

Предварительные требования

• Python 3.12+

• Приложение Anthropic Claude Desktop (или Cursor)

• Pip (менеджер пакетов Python), установка через python

• API-ключ для провайдера рекламных данных, задаётся как SCRAPECREATORS_API_KEY (см. конфигурацию ниже)

• API-ключ Google Gemini для анализа видео (необязательно, нужен только для видеорекламы)

Не хочется возиться с API-ключами? Смотрите [хостинговую версию](# "хостинговая версия" не переведён) выше и пропустите настройку.

Быстрая установка (рекомендуется)

1. Клонируйте и запустите скрипт установки

   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. Настройте свои API-ключи

   Отредактируйте созданный файл .env и добавьте свои API-ключи:

   • Установите API-ключ провайдера рекламных данных как SCRAPECREATORS_API_KEY

   • Получите ключ Gemini в Google AI Studio (необязательно, для видеоанализа)

3. Следуйте отображаемой конфигурации MCP

   Скрипт установки покажет точную конфигурацию, которую нужно добавить в Claude Desktop или Cursor.

Ручная установка

1. Клонируйте этот репозиторий

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

2. Установите зависимости

   pip install -r requirements.txt

3. Настройте API-ключи

   Скопируйте шаблон и укажите свои API-ключи:

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

   Как получить API-ключи:

   • Задайте ваш API-ключ рекламных данных как SCRAPECREATORS_API_KEY в файле .env

   • Получите ключ Google Gemini здесь (необязательно, для видеоанализа)

4. Подключитесь к MCP-серверу

   Добавьте конфигурацию MCP-сервера в конфигурацию Claude Desktop или 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"
         ]
       }
     }
   }

   Замените {{PATH_TO_PROJECT}} на полный путь к каталогу, куда вы клонировали репозиторий.

   Примечание: API-ключи автоматически загружаются из файла .env. Аргументы командной строки по-прежнему поддерживаются и имеют приоритет над переменными окружения.

   Для Claude Desktop:

   Сохраните файл как claude_desktop_config.json в каталоге конфигурации Claude Desktop:

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

   Для Cursor:

   Сохраните файл как mcp.json в вашем каталоге конфигурации Cursor:

   ~/.cursor/mcp.json

5. Перезапустите Claude Desktop / Cursor

   Откройтие Claude Desktop — теперь вы должны увидеть Google Ads Library как доступную интеграцию.

   Или перезапустите Cursor.

Технические детали

1. Claude отправляет запросы к Python MCP-серверу.

2. MCP-сервер запрашивает у рекламного API данные Google.

Google Ads

Этот сервер подключается к рекламному центру Google:

• Google Ads: Для поиска используется домен компании (например, "nike.com") или их рекламного.

• Формат ответа: Возвращает объявления с типами текстов (текст/изображение/видео) и подробными вариантами.

• Детали объявления: Каждое объявление может иметь несколько вариаций с разными заголовками и описаниями.

• Региональные данные: Включает региональную статистику и данные о показах.

Советы:

• Для поиска используйте домены компаний (например, "nike.com"), а не названия брендов.

• Текстовые объявления теперь поддерживаются наряду с изображениями и видео.

• Каждое объявление может иметь несколько вариаций с разными заголовками и описаниями.

Доступные MCP-инструменты

Этот MCP-сервер предоставляет инструменты для работы с объектами Google:

Troubleshooting

Распространённые проблемы

Ошибка «API-ключ не найден»:

• Убедитесь, что ваш .env находится в корне проекта.

• Если у вас нет .env, скопируйте его из примеров: cp .env.template .env

• Проверьте, что ваши ключи корректно отформатированы и не содержат кавычек.

• Убедитесь, что в .env есть SCRAPECREATORS_API_KEY=your_key_here

• Для видеоанализа добавьте GEMINI_API_KEY=your_key_here

Видеоанализ не работает:

• Проверьте наличие корректного ключа Google Gemini в .env

• Для видеоанализа требуется переменная окружения GEMINI_API_KEY

Проблемы с подключением MCP-сервера:

• Проверьте, что путь в конфигурации MCP указывает на правильное собственное.

• Убедитесь, что все зависимости установлены: pip install -r requirements.txt

• После изменения конфигурации перезапустите Claude Desktop/Cursor.

For additional troubleshooting for Claude Desktop integration, see the MCP documentation.

Особенности Google Ads:

• Используйте домены компаний (например, "nike.com") вместо названий брендов для поиска.

• Текстовые объявления теперь поддерживаются наряду с изображениями и видео.

• Каждый объявление может иметь несколько вариантов с разными заголовками и описаниями.

FAQ

Как начать пользоваться Google Ads Library MCP? Самый лёгкий способ — использовать хостинговую версию от Proxy (useproxy). Она не требует API, установки или сервера — нужно подключиться к ChatGPT, Claude, Cursor или любому другому MCP-клиенту и мгновенно отправлять запросы. Вы можете начать бесплатно.

Нужен ли мне API-ключ? Это зависит от того, как вы разворачиваетесь. Хостинговый версия вся вычисляет себя, поэтому не нужны ключи ScrapeCreators и Gemini. Для самостного хостинга нужны SCRAPECOREATORS_API_KEY (и ключ Gemini для видеоанализа).

Какие MCP-клиенты поддерживаются? И hosted, и self-hosted работают с ChatGPT, Claude (Desktop и веб), Cursor, Manus и любым другим клиентом, поддерживающим Model Context Protocol.

Есть ли бесплатная версия? Да, Хостинговая версия от Proxy содержит бесплатный уровень, поэтому можно начать анализировать рекламу без настройки.

Стоит ли самостоятельно размещать или использовать hosted? Выберите хостинговую версию, если нужна просто быстрая и надёжная связь с Google Ads Transparency Center без обслуживания — подходит большинству. Само нested размещайте только если хотите изменять или расширять код самостоятельно.

Feedback

Ваши отзывы будут бесценны. Пожалуйста, сообщите нам, какие функции из списка вы хотите увидеть в будущих версиях, или предложите совершенно новые.

License

Этот проект лицензируется по лицензии MIT.

Сделано с ❤ командой Proxy.