Google Ads MCP: вся структура кампании из вашего агента, одной атомарной операцией

Есть ли MCP-сервер для Google Ads? Да. Hermoso: размещённый MCP-сервер Google Ads. Добавьте https://app.hermoso.ai/mcp в Claude, ChatGPT или Cursor и подключите аккаунт Google Ads один раз. Ваш ассистент сможет создавать поисковые, медийные кампании и кампании Performance Max, подбирать идеи ключевых слов, задавать бюджеты, ставки и таргетинг и строить отчёты. Запуск кампании всегда требует вашего явного подтверждения.

Google Ads: дерево, и именно в деревьях скриптовое создание кампаний обычно ломается. Вы создаёте бюджет, затем кампанию, затем группу объявлений, затем объявление. Если на четвёртом шаге объявление отклонено, у вас остаются три осиротевших объекта и бюджет, который вам не нужен. Чистить это вручную, главная причина, по которой большинство людей бросают автоматизацию Google Ads.

MCP-сервер Hermoso строит всё дерево за одну атомарную операцию, используя временные идентификаторы ресурсов, чтобы дочерние объекты могли ссылаться на родителей, которые ещё не существуют. Либо появляются кампания, группа объявлений, объявление и ключевые слова целиком, либо не появляется ничего. Если объявление отклонено, бюджет тоже не создаётся.

Установите один раз: в Claude.ai или Claude Desktop вставьте https://app.hermoso.ai/mcp в Settings → Connectors и подтвердите доступ своим аккаунтом Hermoso. В кодовом агенте это одна команда: /plugin marketplace add hermoso-ai/hermoso, затем /plugin install hermoso@hermoso в Claude Code, codex plugin marketplace add hermoso-ai/hermoso, затем codex plugin add hermoso@hermoso в Codex, или npx skills add hermoso-ai/hermoso -a cursor в Cursor (вместо cursor укажите своего агента после -a), а затем войдите один раз командой npx -y hermoso auth login. Полная настройка на странице MCP и CLI.

Инструменты Google Ads

Создание. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets для быстрых ссылок, уточнений и структурированных фрагментов.

Настройка. set_google_ads_budget, set_google_ads_bidding (шесть стратегий), set_google_ads_targeting (география и язык), find_google_ads_locations, set_google_ads_networks (партнёры Search и Display вкл. или выкл.), create_google_ads_conversion_action и list_google_ads_conversion_actions.

Исследование. google_ads_keyword_ideas подключает Keyword Planner к разговору: реальные месячные объёмы поиска, конкуренция и диапазоны ставок в верхней части страницы, по набору ключевых слов, посадочной странице или всему сайту.

Чтение и изменение. list_google_ads_campaigns, google_ads_report для произвольного GAQL, google_ads_change_history для того, что и когда менялось в аккаунте, delete_google_ads_object для удаления объекта и set_google_ads_status, единственный переключатель с подтверждением, который запускает реальные расходы.

create_google_ads_campaign также поддерживает режим пробного запуска, поэтому агент может проверить всё дерево по живому API, ничего не создавая. Это хороший вариант по умолчанию, когда агент предлагает план на ваше утверждение.

Что ваш агент может делать с Google Ads MCP

Каждая строка: настоящий инструмент на сервере. Задайте вопрос обычным языком, и агент выберет, какие инструменты запустить.

Примеры запросов

Вставьте любой из них в Claude, ChatGPT или Cursor после подключения Hermoso.

• «Найди 30 ключевых слов для нашего приложения для управления проектами с месячным объёмом поиска больше 1 000 в США и сгруппируй их по намерению.»
  google_ads_keyword_ideas возвращает объёмы, конкуренцию и диапазоны ставок из Keyword Planner, а агент их группирует.
• «Создай кампанию Search на паузе для этих ключевых слов: $50 в день, США и Канада, английский, максимизация конверсий.»
  create_google_ads_campaign строит бюджет, кампанию, группу объявлений, объявление и ключевые слова одной атомарной операцией, на паузе, а затем читает результат.
• «Настрой кампанию Performance Max для нашего каталога Shopify с фидом Merchant Center.»
  list_merchant_accounts выбирает магазин, затем create_google_ads_performance_max_campaign создаёт её на паузе с подключённым фидом.
• «Какие поисковые запросы потратили деньги в прошлом месяце, но не принесли конверсий? Добавь худшие десять как минус-слова.»
  google_ads_report получает отчёт по поисковым запросам, затем add_google_ads_keywords добавляет минус-слова.
• «Добавь четыре быстрые ссылки в нашу брендовую кампанию: цены, демо, кейсы и контакты.»
  add_google_ads_assets создаёт быстрые ссылки и прикрепляет их к кампании.
• «Выключи партнёров Search во всех кампаниях и покажи, что было до и после.»
  set_google_ads_networks сначала читает текущую настройку, а затем меняет её кампания за кампанией.
• «В пятницу кто-то поменял наши ставки. Что изменилось?»
  google_ads_change_history выводит изменения с временем.
• «Подключи наше свойство GA4, чтобы регистрации учитывались как конверсии в Google Ads.»
  link_google_ads_to_analytics связывает два аккаунта, а create_analytics_key_event отмечает событие регистрации как ключевое.

Performance Max, построенный так же

create_google_ads_performance_max_campaign строит кросс-канальный тип кампании Google (Search, YouTube, Display, Discover, Gmail и Maps из одной кампании), и делает это одной атомарной операцией, потому что Google требует именно этого: бюджет, кампания, таргетинг по местоположению и языку, группа ресурсов и все привязки ресурсов уходят вместе, поэтому отклонённый ресурс не оставляет наполовину построенную кампанию. Она создаётся на паузе, а всё дерево читается обратно из Google, прежде чем ваш агент сообщит, что оно существует.

Минимумы ресурсов Google проверяются здесь до отправки, поэтому отсутствие квадратного изображения даёт понятное сообщение, а не непрозрачный отказ API: от 3 до 15 заголовков длиной до 30 символов, от 1 до 5 длинных заголовков до 90 символов, от 2 до 5 описаний до 90 символов, одно название компании до 25 символов и как минимум один логотип, одно маркетинговое изображение и одно квадратное маркетинговое изображение. Сначала загрузите изображения через upload_google_ads_asset и передайте имена ресурсов. Видео YouTube необязательно. Если его не указать, Google создаст его из группы ресурсов.

Performance Max не использует ключевые слова и ручные ставки: он оптимизирует только под конверсии. Поэтому сборка отказывает в аккаунте без включённого действия конверсии, а не создаёт кампанию, которая не может оптимизироваться, и называет оба выхода: создать действие через create_google_ads_conversion_action или выбрать стратегию, которая в нём не нуждается. Брендовые рекомендации включены по умолчанию для новых кампаний PMax начиная с Google Ads API v21, что меняет место привязки названия компании и логотипа; Hermoso привязывает их к кампании за вас.

Performance Max для фида покупок (ритейл) работает так же: передайте merchantCenterId, и кампания будет рекламировать ваш каталог Merchant Center, а feedLabel сузит её до одного фида. Она строится и читается точно так же, как описанная выше кампания. Результат чтения показывает аккаунт Merchant Center и метку фида, которые Google действительно сохранил, поэтому вы видите, что это действительно ритейл-кампания, а не верите нам на слово. Она рекламирует весь фид под одним корневым группирующим листингом; разбиение фида по бренду, категории или пользовательской метке не реализовано, и такой запрос отклоняется с указанием причины, а не игнорируется молча, чтобы вы никогда не решили, что сузили фид, хотя этого не произошло.

Merchant Center, чтобы агент знал, что он продаёт

«Почему этот товар не показывается?», вопрос, на который отчёты Google Ads по структуре не могут ответить, потому что у отклонённого товара нет показов, которые можно было бы отчитать. Ответ находится в Merchant Center, и то же подключение к Google открывает к нему доступ без второго входа.

Ваш агент может получить список аккаунтов Merchant Center, к которым есть доступ у подключённого аккаунта Google, через list_merchant_accounts (у агентства их обычно несколько, поэтому агент уточняет, какой магазин, а не угадывает), прочитать товары в фиде через list_merchant_products (фактический каталог, который обслуживает кампания Shopping или Performance Max для ритейла) и прочитать проблемы уровня аккаунта, которые Google выставляет аккаунту, через list_merchant_issues. Этого достаточно, чтобы писать рекламные тексты о реально существующих товарах по реально действующим ценам и объяснить молчащую кампанию.

Он также записывает данные. create_merchant_data_source создаёт фид API-продукта, upsert_merchant_product помещает в него товар, update_merchant_product меняет поля, которые меняются ежедневно (цену и наличие), а delete_merchant_product и delete_merchant_data_source удаляют их после подтверждения. list_merchant_data_sources показывает, какие фиды вообще принимают запись.

Три вещи стоит знать заранее. Google блокирует все вызовы Merchant API, пока облачный проект Hermoso не зарегистрирован в вашем аккаунте Merchant Center, поэтому register_merchant_developer выполняет эту связку один раз и называет её по имени. Это не сломанное подключение, и переподключение её не исправит. Записи товаров попадают только в фид API: файловый фид, автофид и фид, который создаёт сам интерфейс Merchant Center, отображаются в списке, но все отказывают в записи. Поэтому Hermoso сам подбирает подходящий фид для записи, создаёт его, если его нет, и отказывает по имени, если их несколько, а не кладёт ваш товар на рынок, который, возможно, не таргетирован вашими кампаниями. А upsert_merchant_product: запись всей строки, тогда как update_merchant_product: частичное обновление. В первый передавайте все поля, которые нужно сохранить, во второй, только те, что меняете.

Ничего из этого не означает, что каталог нужно переносить. Если фид уже хранится в Shopify или вашей платформе, оставьте его там и пусть агент его читает; записи нужны для случаев, когда у фида пока нет владельца или когда одну цену или наличие нужно поправить сейчас, а не при следующей синхронизации.

Google Analytics 4, чтобы видеть, что дали клики

Отчёты Google Ads заканчиваются на клике. Что произошло дальше (сессия, регистрация, заказ), хранится в Google Analytics, и тот же вход в Google открывает к нему доступ (это отдельное подключение, потому что ему нужно собственное разрешение).

Ваш агент может определить, какое свойство GA4 читать, через list_analytics_properties. Это важно, потому что каждый вызов Analytics принимает числовой идентификатор свойства, а у вас на руках обычно идентификатор измерения G-XXXXXXXXX из фрагмента отслеживания. Затем analytics_report возвращает сессии, пользователей, конверсии и выручку с разбивкой по каналу, источнику и среде, кампании, посадочной странице, стране, устройству или дате, а analytics_realtime показывает, кто сейчас на сайте. Так «построй кампанию» и «скажи, что она принесла» становятся одним разговором.

Он также записывает данные, и именно это напрямую возвращается в Google Ads: create_analytics_key_event отмечает событие, которое GA4 уже собирает, как ключевое, а Google Ads импортирует его как конверсию, и без действия конверсии ни одна стратегия умных ставок на этой странице не работает. create_analytics_custom_dimension регистрирует параметр события, чтобы отчёты можно было разбивать по нему, а list_analytics_definitions показывает, что свойство уже измеряет, прежде чем добавлять что-либо. Две вещи верны всегда: это только GA4, потому что у API нет поверхности для Universal Analytics вовсе, и пользовательское измерение можно архивировать, но нельзя удалить; на свойство выделено 50 слотов для событий, поэтому агент сначала проверяет существующий набор.

Ограничение запуска расходов шире одного инструмента

Постановка кампании на паузу, не единственный способ избежать расходов, и считать это так, реальная ловушка: создание включённой группы объявлений, объявления или ключевого слова внутри уже включённого родителя начинает показываться на следующем же аукционе. Поэтому то же подтверждение, что защищает set_google_ads_status, защищает и create_google_ads_ad_group, create_google_ads_ad и add_google_ads_keywords, когда родитель активен; это определяется по строке, которую каждый из них уже получает, без дополнительного запроса. Минус-слова только ограничивают расходы, поэтому они никогда не закрываются ограничением.

Отчёты GAQL и одна оговорка

google_ads_report принимает произвольный GAQL, поэтому ваш агент может запросить любой нужный срез, а не ограничиваться фиксированной формой отчёта. Помните об одном, если вы пишете запросы вручную или поручаете их модели: GAQL: не SQL. В нём нет подзапросов, а IN принимает только литеральный список. Конструкция WHERE id IN (SELECT …) недопустима и завершится ошибкой, а не тихо вернёт неверные строки. Результат можно сразу передать в таблицу через create_sheet и append_to_sheet или в документ через create_doc.

Сверка после записи, и только потом отчёт

После мутации дерево читается обратно из Google, и итог, который вы получаете, строится по этому результату, а не по тому, что запрашивалось. Это небольшая дисциплина, которая ловит конкретный сбой, когда агент уверенно описывает кампанию, которую платформа фактически изменила или отклонила.

Что сервер не сделает без вопроса

Агент с бюджетом полезен только тогда, когда масштаб ущерба ограничен, поэтому право на расходы закреплено на сервере, а не в подсказке. Кампании, группы объявлений и объявления Meta создаются со статусом PAUSED без возможности переопределить это вызывающей стороной. Переключатели статуса, которые могут запустить реальные рекламные расходы (один на каждой рекламной платформе: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status и set_openai_ads_status, среди прочих), не выполняются без явного флага подтверждения, и тот же запрет действует на создание включённой группы объявлений, объявления или ключевого слова в Google Ads внутри уже включённого родителя, потому что такой объект показывается на следующем аукционе. Удаление также требует подтверждения. Со стороны генерации hermoso_capabilities публикует точную стоимость каждой модели в кредитах до запуска, а каждая генерация резервирует оценку, а затем списывает фактическую стоимость, поэтому неудачный запуск возвращает кредиты, а не тихо списывает их с вас.

Подключение аккаунта Google Ads

Вы подключаете Google Ads к Hermoso через собственный OAuth-поток Google в разделе «Параметры», «Коннекторы»; пароль через модель не проходит. Подключения Google Ads общие на уровне бренда, поэтому вся команда, работающая с брендом, использует одно подключение, а не каждый человек авторизуется заново.

Креатив

Управление кампаниями полезно только тогда, когда есть что показывать. Тот же сервер исследует, что уже работает на вашем рынке, в библиотеках рекламы Meta, Google и LinkedIn, создаёт готовые графические и видеообъявления на основе вашего реального продукта в более чем 100 моделях и загружает ресурсы, поэтому «что запускать» и «построй это», один разговор, а не два инструмента. См. обзор маркетингового MCP, полный список инструментов или Meta Ads MCP, если вы ведёте и то и другое.

Частые вопросы

Есть ли MCP-сервер для Google Ads?

Да. MCP-сервер Hermoso создаёт и управляет Google Ads из любого MCP-клиента: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad и add_google_ads_keywords для построения дерева поиска или медийной сети; create_google_ads_performance_max_campaign для Performance Max; set_google_ads_budget, set_google_ads_bidding и set_google_ads_targeting для настройки; google_ads_keyword_ideas для исследования в Keyword Planner; list_google_ads_campaigns и google_ads_report для отчётов; чтение Merchant Center для фида товаров за кампанией Shopping; и set_google_ads_status с подтверждением для включения.

Может ли ИИ-агент создать кампанию Google Ads?

Да, и всё дерево создаётся одной атомарной операцией с временными идентификаторами ресурсов: кампания, группа объявлений, адаптивное объявление для поиска или медийной сети и ключевые слова вместе. Если объявление отклонено, бюджет тоже не создаётся, поэтому вам не приходится убирать осиротевшие объекты. Режим пробного запуска проверяет дерево по живому API, ничего не создавая.

Может ли он создать кампанию Performance Max?

Да. create_google_ads_performance_max_campaign создаёт бюджет, кампанию, таргетинг, группу ресурсов и все привязки ресурсов одной атомарной операцией, потому что Google требует их вместе. Кампания создаётся на паузе и читается обратно, прежде чем агент сообщит о ней. Минимумы ресурсов Google соблюдаются до отправки: от 3 до 15 заголовков, от 1 до 5 длинных заголовков, от 2 до 5 описаний, название компании и как минимум один логотип, одно маркетинговое изображение и одно квадратное маркетинговое изображение. PMax оптимизируется только под конверсии, поэтому он отказывает в сборке в аккаунте без включённого действия конверсии, вместо того чтобы создать кампанию, которая не может оптимизироваться. Performance Max для фида покупок (ритейл) работает так же: передайте merchantCenterId, и кампания будет рекламировать ваш каталог Merchant Center, а feedLabel сузит её до одного фида; результат чтения показывает аккаунт Merchant Center и метку фида, которые Google действительно сохранил.

Работает ли это с Google Merchant Center?

Да, чтение и запись через то же подключение Google. Агент может получить список аккаунтов Merchant Center, доступных вашему аккаунту, прочитать товары в фиде (каталог, который фактически обслуживает кампания Shopping или Performance Max для ритейла) и прочитать проблемы уровня аккаунта, которые выставляет Google. Это единственное место, где можно узнать, почему товар не показывается, потому что у отклонённого товара нет показов для отчёта Google Ads. Google требует однократной регистрации облачного проекта Hermoso в вашем аккаунте Merchant Center, прежде чем API начнёт отвечать, и есть инструмент, который это делает. Запись тоже поддерживается: create_merchant_data_source, upsert_merchant_product, update_merchant_product для ежедневно меняющихся цен и наличия, а также delete_merchant_product и delete_merchant_data_source с подтверждением. Google принимает записи товаров только в фид API, поэтому Hermoso сам выбирает подходящий фид и отказывает по имени, если в аккаунте их несколько.

Может ли он делать исследование ключевых слов?

Да. google_ads_keyword_ideas обращается к Keyword Planner от Google и возвращает реальные месячные объёмы поиска, конкуренцию и диапазоны ставок в верхней части страницы, по ключевым словам, URL посадочной страницы или всему сайту. Агент может сразу передать их в add_google_ads_keywords или записать в таблицу Google Sheets.

Может ли он начать тратить мой бюджет Google Ads?

Только с явного подтверждения. set_google_ads_status: переключатель, который запускает реальные деньги, а поскольку создание включённого дочернего объекта внутри уже включённого родителя начинает показываться на следующем аукционе, то же подтверждение защищает create_google_ads_ad_group, create_google_ads_ad и add_google_ads_keywords, когда родитель активен. Минус-слова только ограничивают расходы и никогда не закрываются ограничением.

Может ли он строить отчёты?

Да. google_ads_report принимает произвольный GAQL, поэтому агент может запросить любой нужный срез. Обратите внимание: GAQL: не SQL. В нём нет подзапросов, а IN принимает только литеральный список, поэтому WHERE id IN (SELECT …) недопустимо. Результаты можно сразу записать в таблицу или документ Google.

Какие стратегии ставок и таргетинга он может задать?

Шесть стратегий назначения ставок, расписание кампании, геотаргетинг и таргетинг по языку, а find_google_ads_locations находит местоположения по названию. Бюджеты задаются через set_google_ads_budget, а ключевые слова поддерживают минус-слова и CPC для каждого ключевого слова.

Получает ли агент мой пароль от Google?

Нет. Вы подключаете Google Ads через собственный OAuth-поток Google в разделе «Параметры», «Коннекторы» Hermoso, а Hermoso хранит полученный токен. Агент только вызывает инструменты Hermoso. Подключения Google Ads общие на уровне бренда, поэтому вся команда работает через одно подключение.

Может ли он сделать и креатив для объявления?

Да. Тот же сервер исследует рекламу конкурентов, планирует концепцию, создаёт готовые графические и видеокреативы в более чем 100 моделях с вашим реальным продуктом внутри и загружает ресурсы через upload_google_ads_asset, поэтому исследование, креатив и построение кампании происходят в одном разговоре.