Google Merchant Center MCP

English | Русский

A1 Google Merchant Center MCP подключает AI-приложение к вашему аккаунту Google Merchant Center. Узнавайте, почему товары отклонены, просматривайте фиды и акции, изучайте отчёты и рыночные цены, а затем вносите осознанные изменения в данные о товарах, когда это необходимо.

Он работает с данными Merchant Center, которые стоят за объявлениями Shopping: товарами, источниками данных, акциями и отчётами. Кампании, бюджеты и ставки относятся к Google Ads и находятся за пределами этого сервера.

• 22 инструмента. 15 операций только читают данные Merchant Center; 5 записывают данные товаров, источников данных или акций; 2 потенциально деструктивны.

• Ваш доступ к Google. Сервер использует ваши учётные данные OAuth и Merchant API v1 — он не создаёт отдельный аккаунт Merchant Center.

• Изменения с учётом источника. Входные данные товаров и акций можно изменять только через API-источник данных. Файловый фид можно перезапросить, но его содержимое здесь не редактируется.

• Видимые границы. Инструменты имеют метаданные «только чтение», «запись» или «деструктивные», поэтому AI-клиент может отличить проверку от реального изменения.

Начните с вопроса, который только читает данные:

Какие товары отклонены и о каких проблемах сообщает Google по каждому из них?

Подключить сервер · Примеры использования · Техническая документация

Посмотрите, как это работает, за минуту

Вы: Какие товары отклонены и о каких проблемах сообщает Google по каждому из них?

Ассистент: Перечисляет затронутые товары и объясняет проблемы уровня товара, о которых сообщает Merchant Center.

Вы: Покажи текущую цену и наличие товара SKU-123, затем подготовь обновление наличия до in_stock.

Ассистент: Показывает текущие входные данные товара, API-источник данных, к которому он относится, и точное изменение, которое нужно внести. Перед обновлением активных входных данных товара он запрашивает подтверждение.

Вы: Подтверждаю обновление.

Ассистент: Отправляет обновление и объясняет, что Merchant Center обрабатывает данные о товарах асинхронно. Обновление обработанного товара и его статуса качества может занять несколько минут.

Related MCP server: gmc-mcp

Содержание

• Быстрый старт

• Что можно попросить

• Как подключены данные Merchant Center

• Что можно изменить

• Получение доступа

• Конфигурация

• Данные и телеметрия

• Ограничения и фоновая работа

• Техническая документация

• Поддержка

Быстрый старт

Вам понадобятся Node.js 20+, аккаунт Google Merchant Center, учётные данные OAuth из Google Cloud и проект Google Cloud, зарегистрированный в Merchant Center. Процесс получения доступа описан в разделе Получение доступа.

1. Подготовьте четыре значения: идентификатор клиента OAuth, секрет клиента OAuth, токен обновления OAuth и идентификатор аккаунта Merchant Center.

2. Добавьте сервер в ваше AI-приложение, используя одну из инструкций ниже.

3. Задайте первый вопрос из примера выше (он только читает данные).

В приложении:

1. Откройте Настройки → Плагины → MCP servers.

2. Выберите Добавить сервер.

3. Добавьте команду запуска npx -y mcp-google-merchants@latest и четыре переменные окружения ниже.

Из командной строки:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

Проверьте подключение:

codex mcp list

Документация Codex MCP

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

Проверьте подключение:

claude mcp list

Документация Claude Code MCP

1. Откройте Claude Desktop и перейдите в Настройки → Разработчик.

2. Выберите Изменить конфигурацию.

3. Добавьте сервер в mcpServers:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Если пункт Изменить конфигурацию недоступен, откройте файл конфигурации напрямую:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Документация Claude Desktop MCP

Добавьте сервер уровня пользователя в ~/.cursor/mcp.json на macOS/Linux или %USERPROFILE%\.cursor\mcp.json на Windows:

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Документация Cursor MCP

Выполните команду MCP: Open User Configuration в палитре команд и добавьте:

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

Проверьте сервер с помощью MCP: List Servers.

Документация VS Code MCP

Что можно попросить

Поиск и анализ проблем каталога

• Какие товары отклонены и что сообщает Google по каждому из них?

• Покажите название, цену, наличие и текущий статус товара SKU-123.

• Какие товары отсутствуют на складе?

• Покажите самые частые проблемы товаров для этого аккаунта Merchant Center.

Изучение эффективности и цен

• Покажите клики и показы по товарам за июль.

• Какие товары имеют цену выше рыночного ориентира в США?

• Какие цены предлагает Google и какое влияние он прогнозирует?

Сравнение цен и рекомендации требуют бесплатного подключения Market Insights в Merchant Center. Если аккаунт не подключён к этой функции, сервер объясняет, почему в отчёте нет строк.

Просмотр аккаунта и фидов

• Перечислите аккаунты Merchant Center, к которым у меня есть доступ.

• Подтверждена ли домашняя страница магазина? Покажите текущие настройки доставки.

• Перечислите источники данных о товарах и акциях и определите API-источник данных.

• Выполните внеочередную выборку этого запланированного файлового фида сейчас.

Внесение осознанных изменений

• Обновите цену и наличие этого товара в его API-источнике данных.

• Создайте API-источник данных для нового фида товаров.

• Создайте или обновите акцию, а затем проверьте её статус одобрения.

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

Как подключены данные Merchant Center

Merchant Center разделяет входящие данные и итоговый статус товара:

1. Аккаунт содержит источники данных о товарах и акциях.

2. Источник данных может быть API-источником, файлом, таблицей Google Sheets, интерфейсом Merchant Center или автоматическим фидом.

3. Входные данные товара — это данные о товаре, предоставленные одним источником.

4. Обработанный товар — это то, что Merchant Center получает после обработки этих входных данных. Он включает пригодность к показу и проблемы на уровне товара.

Сервер может читать все перечисленные типы источников. Он может создавать API-источники данных и обновлять входные данные товара только в API-источнике; он не может записывать данные в файл, интерфейс или автоматический фид. Чтобы найти товары по условию, используйте отчётный запрос: сам list_products не поддерживает фильтрацию на стороне сервера.

Что можно изменить

MCP-клиент решает, как запрашивать у вас подтверждение для инструментов записи и деструктивных инструментов. Сервер помечает свои операции как операции только для чтения, записи или деструктивные, чтобы клиент мог показать правильную границу.

Получение доступа

Сервер использует Google Merchant API и область OAuth https://www.googleapis.com/auth/content.

1. Создайте или выберите проект Google Cloud, включите Merchant API и настройте экран согласия OAuth.

2. В Google Cloud создайте OAuth-клиент типа Desktop app. Сохраните его идентификатор клиента и секрет клиента.

3. Авторизуйте аккаунт Google, у которого есть доступ к вашему Merchant Center, и получите токен обновления для указанной выше области. В этом может помочь OAuth 2.0 Playground: включите параметр Use your own OAuth credentials, введите область, авторизуйтесь и обменяйте код на токены.

4. Найдите идентификатор аккаунта Merchant Center в Merchant Center и используйте его как GOOGLE_MERCHANTS_ACCOUNT_ID.

5. Зарегистрируйте проект Google Cloud в Merchant Center один раз. Google требует аккаунт Merchant Center для продакшена с подтверждённым сайтом и администратором аккаунта для этой операции. Регистрация связывает один облачный проект с ак

Относитесь к секрету клиента OAuth и токену обновления как к паролям. Они хранятся в конфигурации MCP-клиента и могут предоставлять доступ к аккаунту Merchant Center.

Конфигурация

* Используйте либо идентификатор клиента, секрет клиента и токен обновления вместе, либо заранее выпущенный токен доступа. Токен доступа обычно истекает примерно через час; токен обновления позволяет серверу получать новый токен доступа по мере необходимости.

Данные и телеметрия

Сервер запускается локально как процесс, запускаемый вашим ИИ-приложением. Он отправляет запросы Merchant Center в Google и обновляет токены доступа OAuth через конечную точку OAuth Google.

Он отправляет анонимную телеметрию использования для подсчёта активных установок и востребованности инструментов: случайный идентификатор установки, версию пакета, версии ИИ-клиента, Node.js и операционной системы, а также имя инструмента. Он никогда не отправляет и не хранит токены OAuth, данные Merchant Center, аргументы инструментов или промпты. Отключите эту телеметрию для A1 MCP-серверов с помощью:

ASKADS_TELEMETRY=0

Ограничения и фоновая работа

• Обработка Merchant Center асинхронна. Недавно добавленный, обновлённый или удалённый товар может появиться в обработанных товарах через несколько минут. Проблемы с одобрением товаров и акций появляются позже, а не как немедленная ошибка API.

• Market Insights необязателен. Отчёты о ценовой конкурентоспособности и рекомендованных ценах возвращают данные только после того, как аккаунт подпишется на бесплатную программу Market Insights.

• Квоты зависят от аккаунта и метода API. Проверяйте текущее потребление с помощью list_method_quotas; дневные счётчики Google сбрасываются в 12:00 UTC.

• Временные ограничения обрабатываются осторожно. Когда Google возвращает 429, сервер следует заголовку Retry-After, если он предоставлен, и выполняет ограниченное количество повторных попыток. Он не повторяет запись после неопределённого сетевого или серверного сбоя.

• Фонового мониторинга нет. Сервер работает только пока ИИ-приложение вызывает его. Если ваше ИИ-приложение поддерживает запланированные задачи, вы можете попросить его периодически проверять проблемы с товарами или использование квот.

• Сводные проблемы товаров имеют ограничение по аккаунтам. list_product_issues работает для автономных аккаунтов и субаккаунтов, но не для продвинутых родительских аккаунтов.

Техническая документация

• Каталог возможностей MCP — страницы, ориентированные на задачи, для каждого инструмента.

• Все инструменты и их входные данные

• Документация для разработчиков

• Документация по публикации

• Обзор Google Merchant API

• Аутентификация Google Merchant API

• Регистрация разработчика Google

Поддержка

Нашли ошибку или нужен сценарий? Создайте issue или напишите в Telegram.