Зачем это вообще нужно
У Google Ads есть Keyword Planner — официальный инструмент подбора ключевых слов с реальными цифрами: сколько раз в месяц ищут фразу, какая там конкуренция, сколько может стоить клик. Данные точные, потому что они прямо из первоисточника. Идея была простая: дать ИИ-ассистенту доступ к этим данным через протокол MCP (Model Context Protocol), чтобы не переключаться между вкладками и не копировать цифры руками.
Выбор реализации
Официальный MCP-сервер от Google для Ads API существует, но на практике умеет только общие запросы к аккаунту — списки клиентов, произвольные GAQL-запросы, метаданные. Про Keyword Planner там нет ни слова. Пришлось смотреть сторонние open-source реализации. Разброс большой: от тяжёлых серверов на 30+ инструментов с управлением кампаниями и бюджетами до узких утилит на три команды. Для задачи «просто дай цифры по ключевым словам» тяжёлый вариант был бы избыточным риском — лишние права ради функциональности, которая не нужна. Остановился на компактном сервере под названием google-keyword-planner-mcp — нативный исполняемый файл без Python и Node.js, три инструмента: генерация идей по ключевым словам, исторические метрики, прогноз показов и кликов. Открытый код, MIT-лицензия, можно прочитать целиком за десять минут.
Первая неожиданность: developer token без управляющего аккаунта не выдаётся
Чтобы дёргать Google Ads API, нужен так называемый developer token. Логично было пойти в уже существующий рекламный аккаунт и получить его там — но раздел «Центр API» в Google Ads оказался доступен только из управляющего аккаунта (MCC), а не из обычного рекламного. Обычный аккаунт этот раздел просто не показывает, без объяснений в интерфейсе. Пришлось завести отдельный управляющий аккаунт — бесплатно, без привязки карты, но это отдельный шаг, о котором нигде явно не предупреждают заранее.
OAuth-клиент и разовая авторизация
Дальше — стандартный путь для настольных приложений Google: в Google Cloud создаётся OAuth-клиент типа «Desktop app», включается Google Ads API. Токен обновления (refresh token) получается один раз простым скриптом: он поднимает локальный HTTP-сервер на порту, открывает страницу авторизации в браузере, ловит код возврата и меняет его на токены. После этого повторный вход не нужен — сервер обновляет доступ сам.
Второй нюанс: тестовый уровень доступа по умолчанию
Сервер запустился, протокол ожил, список инструментов отдаётся корректно — а вот реальный запрос к живому рекламному аккаунту вернул отказ: новый developer token по умолчанию работает только с тестовыми аккаунтами. Чтобы получить данные по настоящему аккаунту, нужно отдельно подавать заявку на расширенный уровень доступа (Basic/Standard) и ждать рассмотрения. Технически всё готово и работает — но именно этот шаг растягивается по времени сильнее всего, и на него стоит закладывать запас, а не рассчитывать на мгновенный результат.
Что в итоге
Сама интеграция — дело пары часов: скачать бинарник, завести учётные данные, один раз пройти авторизацию, зарегистрировать сервер. Основное время съедают не технические шаги, а бюрократия на стороне Google — управляющий аккаунт, который не создаётся автоматически, и очередь на расширенный доступ. Дальше это уже рутинный инструмент: ИИ смотрит реальный спрос по ключевым словам прямо во время работы над текстом или рекламной кампанией, без переключения контекста и без догадок на глаз.
Если вы делаете что-то похожее — закладывайте отдельное время именно на административную часть у Google, а не только на саму установку MCP-сервера.
