Google Ads

Подключите LLM к Google Ads API для доступа к данным через диалог. Получайте информацию об аккаунте, список клиентов и запрашивайте эффективность рекламы на естественном языке. Интегрируется с Gemini CLI и Code Assist.

Аналитика и мониторинг Маркетинговая автоматизация Data Science и ML ★ 295 GitHub (295 ★)

Инструмент Google Ads предоставляет экспериментальный сервер Model Context Protocol (MCP), который интегрирует Google Ads API с большими языковыми моделями (LLM). Это позволяет пользователям взаимодействовать со своими аккаунтами Google Ads с помощью подсказок на естественном языке, используя конкретные инструменты, такие как search для получения информации об аккаунте и list_accessible_customers для идентификации доступных аккаунтов клиентов. Он упрощает процесс запросов и управления данными Google Ads через интерфейсы диалогового ИИ, такие как Gemini CLI или Gemini Code Assist.

Ключевые возможности

01Настраивается с помощью параметров клиентской библиотеки Python для Google Ads API

02Поддерживает Application Default Credentials (ADC) для аутентификации

03Интегрируется с Gemini CLI и Gemini Code Assist

04Получает информацию об аккаунте Google Ads через подсказки LLM

05Перечисляет доступные аккаунты клиентов через запросы на естественном языке

06295 звёзд на GitHub

Варианты использования

01Мониторинг эффективности кампаний Google Ads с помощью запросов на естественном языке

02Определение доступных аккаунтов клиентов Google Ads

03Запрос количества активных кампаний для определённых ID клиентов

04Получение аналитики по данным рекламного аккаунта через диалоговый ИИ

Google Ads MCP Server (Experimental)

This repo contains the source code for running a local MCP server that interacts with the Google Ads API.

Tools

The server uses the Google Ads API to provide several Tools for use with LLMs.

Tools available

search: Retrieves information about the Google Ads account.
list_accessible_customers: Returns names of customers directly accessible by the user authenticating the call.

Notes

The MCP Server will expose your data to the Agent or LLM that you connect to it.
If you have technical issues, please use the GitHub issue tracker.
To help us collect usage data, you will notice an extra header has been added to your API calls, this data is used to improve the product.

Setup instructions

Setup involves the following steps:

Configure Python.
Configure Developer Token.
Enable APIs in your project
Configure Credentials.
Configure Gemini.

Configure Python

Install pipx.

Configure Developer Token

Follow the instructions for Obtaining a Developer Token.

Record 'YOUR_DEVELOPER_TOKEN', you will need this for the the 'Configure Gemini' step below

Enable APIs in your project

Follow the instructions to enable the following APIs in your Google Cloud project:

Google Ads API

Configure Credentials

Option 1: Configure credentials using Application Default Credentials

Configure your Application Default Credentials (ADC). Make sure the credentials are for a user with access to your Google Ads accounts or properties.

Credentials must include the Google Ads API scope:

https://www.googleapis.com/auth/adwords

Check out Manage OAuth Clients for how to create an OAuth client.

Here are some sample gcloud commands you might find useful:

Set up ADC using user credentials and an OAuth desktop or web client after downloading the client JSON to YOUR_CLIENT_JSON_FILE.

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

Set up ADC using service account impersonation.

gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform

When the gcloud auth application-default command completes, copy the PATH_TO_CREDENTIALS_JSON file location printed to the console in the following message. You will need this for a later step!

Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]

Option 2: Configure credentials using the Google Ads API Python client library.

Follow the instructions to setup and configure the Google Ads API Python client library

If you have already done this and have a working google-ads.yaml , you can reuse this file!

In the utils.py file, change get_googleads_client() to use the load_from_storage() method.

Configure Gemini

Install Gemini CLI or Gemini Code Assist
Create or edit the file at ~/.gemini/settings.json, adding your server to the mcpServers list.

Option 1: the Application Default Credentials method

Replace PATH_TO_CREDENTIALS_JSON with the path you copied in the previous step.

We also recommend that you add a GOOGLE_CLOUD_PROJECT attribute to the env object. Replace YOUR_PROJECT_ID in the following example with the project ID of your Google Cloud project.

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Option 2: the Python client library method

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Login Customer Id

If your access to the customer account is through a manager account, you will need to add the customer ID of the manager account to the settings file.

See here for details.

The final file will look like this:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_CUSTOMER_ID"
      }
    }
  }
}

Try it out

Launch Gemini Code Assist or Gemini CLI and type /mcp. You should see google-ads-mcp listed in the results.

Here are some sample prompts to get you started:

Ask what the server can do:
```
what can the ads-mcp server do?
```
Ask about customers:
```
what customers do I have access to?
```

Ask about campaigns

How many active campaigns do I have?

How is my campaign performance this week?

Note about Customer ID

Your agent will need and ask for a customer id for most prompts. If you are moving between multiple customers, including the customer ID in the prompt may be simpler.

How many active campaigns do I have for customer id 1234567890

Contributing

Contributions welcome! See the Contributing Guide.

Google Ads MCP сервер (экспериментальный)

Этот репозиторий содержит исходный код для запуска локального MCP-сервера, который взаимодействует с Google Ads API. Сервер предоставляет LLM-агентам доступ к данным вашего рекламного аккаунта Google.

Инструменты

Сервер использует Google Ads API и предоставляет следующие MCP-инструменты:

search — поиск информации об аккаунте Google Ads.
list_accessible_customers — возвращает список клиентов, напрямую доступных пользователю, прошедшему аутентификацию.

Важные замечания

MCP-сервер предоставляет агенту или LLM доступ к вашим данным. Убедитесь, что вы доверяете источнику.
При возникновении технических проблем используйте GitHub Issues.
Для улучшения продукта в API-запросы добавляется дополнительный заголовок для сбора статистики использования.

Установка и настройка

Настройка включает несколько шагов:

Установка Python и pipx.
Получение Developer Token.
Включение API в проекте Google Cloud.
Настройка учётных данных.
Настройка Gemini CLI или Gemini Code Assist.

1. Установка Python и pipx

Установите pipx.

2. Получение Developer Token

Следуйте инструкции по получению Developer Token. Сохраните полученный токен — он понадобится на шаге 5.

3. Включение API в проекте Google Cloud

Включите следующие API в вашем проекте Google Cloud:

Google Ads API

4. Настройка учётных данных

Выберите один из двух вариантов:

Вариант 1: Application Default Credentials (ADC)

Настройте ADC. Учётные данные должны иметь доступ к вашим аккаунтам Google Ads и включать OAuth-область:

https://www.googleapis.com/auth/adwords

Примеры команд gcloud:

# Аутентификация через OAuth desktop/web клиент
gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

# Или через сервисный аккаунт
gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform

После выполнения команды скопируйте путь до файла с учётными данными (PATH_TO_CREDENTIALS_JSON) — он потребуется далее.

Вариант 2: Python client library

Следуйте инструкции по настройке Python-клиента Google Ads API. Если у вас уже есть рабочий файл google-ads.yaml, вы можете использовать его. В файле utils.py измените метод get_googleads_client() на использование load_from_storage().

5. Настройка Gemini

Установите Gemini CLI или Gemini Code Assist.

Создайте или отредактируйте файл ~/.gemini/settings.json и добавьте сервер в список mcpServers.

Для варианта 1 (ADC):

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Для варианта 2 (Python client library):

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

Если доступ к аккаунту осуществляется через менеджер-аккаунт:

Добавьте переменную GOOGLE_ADS_LOGIN_CUSTOMER_ID с ID менеджера.

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_CUSTOMER_ID"
      }
    }
  }
}

Проверка работы

Запустите Gemini Code Assist или Gemini CLI и введите команду /mcp. В списке должен появиться google-ads-mcp.

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

Что умеет сервер? "what can the ads-mcp server do?"
Список клиентов: "what customers do I have access to?"
Активные кампании: "How many active campaigns do I have?"
Статистика за неделю: "How is my campaign performance this week?"

Замечание о Customer ID

Для большинства запросов агенту потребуется ID клиента (Customer ID). Если вы работаете с несколькими клиентами, указывайте ID прямо в запросе, например: "How many active campaigns do I have for customer id 1234567890?"

Вклад в проект

Приветствуются любые вклады. См. Contributing Guide.

Источник: https://mcpmarket.com/server/google-ads-8