Google Ads MCP
MCP сервер для Google Ads: разбор кампаний, метрик и ключевых слов через запросы GAQL прямо в диалоге с агентом
- 721 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает рекламные и финансовые данные аккаунта Google Ads
- Работает с токеном разработчика и учетными данными OAuth
- Выполняет произвольные запросы GAQL по вашим аккаунтам
Установка
- Работает в
Ручная установка
git clone https://github.com/cohnen/mcp-google-ads.git
cd mcp-google-ads
uv venv .venv
uv pip install -r requirements.txtПакета в PyPI нет, сервер запускается из склонированного репозитория через python из .venv.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает рекламные и финансовые данные аккаунта Google Ads
- Работает с токеном разработчика и учетными данными OAuth
- Выполняет произвольные запросы GAQL по вашим аккаунтам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает рекламные данные Google Ads к агенту. Он показывает список аккаунтов, отдает метрики по кампаниям и объявлениям за выбранный период и выполняет произвольные запросы на языке GAQL. Результат можно вернуть таблицей, в JSON или CSV, а агент разбирает динамику, находит слабые места и предлагает, что улучшить. Данные только читаются, менять ставки и бюджеты сервер не умеет.
Для кого. Для специалистов по контекстной рекламе, маркетологов и владельцев, кто ведет кампании в Google Ads.
Подходит, если
- Нужен разбор эффективности кампаний и объявлений на естественном языке
- Нужно быстро выполнить запрос GAQL без интерфейса Google Ads
- Нужно найти слабые ключевые слова и точки роста
Не подходит, если
- Нужно менять ставки, бюджеты или запускать кампании: сервер только читает
- Нет токена разработчика Google Ads API и доступа к аккаунту
Пример запроса к агенту
Покажи топ-10 кампаний за 30 дней и выдели те, где ROAS ниже 2, предложи, что улучшитьMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
GOOGLE_ADS_CREDENTIALS_PATHобязательная, секрет- Путь к файлу учетных данных OAuth или сервисного аккаунта
GOOGLE_ADS_DEVELOPER_TOKENобязательная, секрет- Токен разработчика Google Ads API
GOOGLE_ADS_AUTH_TYPE- Тип аутентификации: oauth или service_account
GOOGLE_ADS_LOGIN_CUSTOMER_ID- Id менеджерского аккаунта для доступа к нескольким клиентам
Ограничения
Нужны проект в Google Cloud с включенным Google Ads API, токен разработчика и учетные данные OAuth или сервисного аккаунта, а для менеджерского аккаунта еще и login customer id. Токен разработчика выдают после заявки, сначала в тестовом режиме с ограничениями. Устанавливается из клонированного репозитория через виртуальное окружение Python, пакета в PyPI нет. Сервер только читает данные и не меняет настройки рекламы.
Как отключить. Удалите блок googleAdsServer из конфигурации MCP-клиента и перезапустите его, затем при желании удалите папку репозитория с виртуальным окружением.
Частые вопросы
Где взять токен разработчика?
В аккаунте Google Ads в разделе API Center по заявке. Сначала выдают тестовый токен с ограничениями, после проверки можно получить рабочий.
Можно ли менять кампании?
Нет. Набор инструментов охватывает чтение аккаунтов, метрик и запросы GAQL, изменение ставок и бюджетов не предусмотрено.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыGoogle, Meta Ads и GA4 MCP
Google + Meta Ads + GA4 MCP
Удаленный MCP-сервер для Google Ads, Meta Ads и Google Analytics 4 в одном подключении, вход по OAuth без API-ключей
Экспериментальный официальный MCP-сервер Google Analytics 4: отчеты, воронки и данные реального времени по запросу агенту
Один MCP-сервер для рекламных кабинетов, аналитики и CRM: Google Ads, Meta Ads, GA4, TikTok Ads и LinkedIn Ads
MCP-сервер для Google Ads, Reddit Ads и GA4: агент читает отчеты и правит кампании, а реальный расход включаете только вы
MCP-сервер GA4: агент читает отчеты Google Analytics 4, схему, данные реального времени и разбирает трафик по готовым методикам.
Search Console MCP — данные Google, Bing и GA4 для агента
Search Console MCP
MCP-сервер дает агенту данные Google Search Console, Bing Webmaster, GA4 и AdSense с готовыми SEO-проверками
Коротко о README
README ведет пошагово даже без опыта в коде: настройка доступа к Google Ads API, выбор между OAuth и сервисным аккаунтом, получение токена разработчика. Описаны установка Python и зависимостей, работа через файл .env и конфигурации для Claude Desktop и Cursor. Перечислены инструменты list_accounts, execute_gaql_query, get_campaign_performance, get_ad_performance и run_gaql с примерами запросов GAQL. Есть раздел диагностики и тестовые скрипты для проверки подключения. Лицензия MIT, репозиторий развивает команда ixigo.