Получайте актуальные данные о вашем аккаунте Merchant Center непосредственно из выбранного вами помощника по программированию. В рамках вашей интегрированной среды разработки (IDE) или пользовательской агентской среды теперь вы можете получать доступ к данным Merchant Center и управлять ими, используя службу протокола контекста модели (MCP). Эта служба позволяет вашему помощнику по программированию или агенту выполнять операции чтения и безопасной записи данных Merchant Center, что позволяет ему диагностировать проблемы, проверять программы и запрашивать отчеты с авторитетным контекстом в режиме реального времени.
Для получения более подробной информации о самом протоколе см. стандарт Model Context Protocol .
Безопасность и контроль доступа
При проектировании сервера Merchant Data MCP приоритет отдается безопасности:
- Аутентификация : Выполнение инструмента строго регулируется стандартной аутентификацией API продавца , требующей использования OAuth 2.0 или учетных данных сервисной учетной записи.
- Безопасность выполнения : Несмотря на широкую доступность схем инструментов для вашего агента, фактическое выполнение любого инструмента остается крайне безопасным и строго ограничено вашими конкретными учетными данными API.
Важные соображения
Перед использованием этих инструментов ознакомьтесь со следующими рекомендациями и ограничениями:
Изменения и релизы
Мы будем публиковать информацию об изменениях в примечаниях к выпуску, но они могут вступить в силу немедленно, без периода устаревания.
Безопасное тестирование
Мы рекомендуем сначала поэкспериментировать, используя тестовый или нерабочий аккаунт, прежде чем применять эти инструменты в реальной производственной среде.
Совместная квота
Сервер MCP использует тот же пул квот, что и стандартные вызовы API продавца. Запущенные агенты могут быстро исчерпать квоту, особенно при получении данных из источников. Мы настоятельно рекомендуем использовать тестовый аккаунт, чтобы предотвратить сбои в работе сервиса в производственной среде.
Фильтрация инструментов и безопасность
В будущем Google может добавить на этот MCP-сервер новые инструменты (включая возможности записи). Чтобы предотвратить автоматическое и непреднамеренное выполнение новых или рискованных инструментов вашим ИИ-агентом, мы настоятельно рекомендуем явно настроить клиент на использование встроенной фильтрации инструментов, а не предоставлять доступ ко всему набору инструментов.
Область применения и ограничения
- Ориентация только на чтение : В качестве меры предосторожности на этом начальном этапе инструменты строго ограничены операциями только для чтения и инструментами записи с низким риском (например, созданием источников данных).
Доступные возможности
С помощью сервера Merchant Data MCP вы можете выполнять следующие действия в агентском режиме:
- Получите подробный статус и контекст отчетности для конкретных продуктов, используя точные названия ресурсов.
- Составляйте списки и осуществляйте поиск нескольких товаров.
- Получайте данные о производительности, статусе товаров и ценовой информации с помощью отчетов о поиске.
- Вывод списка, создание, получение и проверка статуса загрузки источников данных.
- Выявите проблемы на уровне учетных записей, влияющие на видимость продукта или участие в программе.
- Перечислите общие причины отказа в приемке продукции по всему вашему ассортименту.
- Проверьте активные регионы, невыполненные требования и штат участия для конкретных программ Merchant Center.
- Проверьте настройки автоматической обработки товаров, изображений и доставки.
Настраивать
Чтобы подключить вашу IDE или помощника по программированию к серверу Merchant Data MCP, обновите настройки клиента MCP. Например, обновите файл mcp.json для Claude Desktop, Antigravity, Visual Studio Code или вашей пользовательской платформы агентов.
Для настройки локального сервера MCP требуется учетная запись службы . Стандартная аутентификация OAuth для пользователей не поддерживается при локальном выполнении в режиме без графического интерфейса. Необходимо создать учетную запись службы, загрузить файл закрытого ключа в формате JSON и указать путь к нему вместе с вашим конкретным идентификатором Merchant Center в качестве аргументов.
Подробные инструкции по созданию и загрузке служебной учетной записи см. в руководстве по служебным учетным записям .
Конфигурация клиента
Настройки конфигурации:
Антигравитация
Следуйте инструкциям в документации по системе Antigravity .
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Клод Рабочий стол
Следуйте инструкциям в документации Claude Desktop .
{
"mcpServers": {
"merchant-data-mcp": {
"command": "npx",
"args": [
"-y",
"@google/merchant-data-mcp",
"--credentials",
"/path/to/your/service-account-file.json"
]
}
}
}
Примеры сценариев использования
Сервер Merchant Data MCP позволяет вашему агенту взаимодействовать с данными Merchant Center в режиме реального времени. Вот несколько распространенных сценариев:
Сценарий 1: Диагностика причин недовольства продукцией
Вы хотите понять, почему конкретный товар не отображается в результатах поиска Google.
Запрос пользователя:
"Почему мой товар с идентификатором предложения 'offer123' отклонен?"
Поведение агента при использовании MCP:
- Агент вызывает функции
list_productsилиget_product_by_name, чтобы определить статус товара. - Сервер MCP возвращает статус товара, включая список
issues(например, «Неправильный формат цены» или «Отсутствует стоимость доставки»). - Агент анализирует проблемы и объясняет вам их первопричину, предлагая способы их решения (например, обновление информации о ценах).
Сценарий 2: Проверка автоматических улучшений
Вам необходимо проверить, активированы ли у вас функции автоматической доставки.
Запрос пользователя:
«Включены ли у меня автоматические улучшения доставки?»
Поведение агента при использовании MCP:
- Агент вызывает
get_automatic_improvementsдля получения настроек на уровне учетной записи. - Сервер MCP возвращает конфигурацию, отображающую статус улучшений в отношении изображений, товаров и доставки.
- Агент подтверждает, что улучшения в доставке активированы, или объясняет, как их включить, если они отключены.
Сценарий 3: Показатели производительности запросов
Вы хотите быстро проверить свои последние показатели, не переходя в пользовательский интерфейс Merchant Center.
Запрос пользователя:
«Покажите мне 5 товаров, показавших лучшие результаты по количеству кликов за прошлую неделю».
Поведение агента при использовании MCP:
- Агент формирует запрос на языке запросов Merchant Center Query Language (MCQL), нацеленный на таблицу
product_performance_view, сортируя поclicks DESCи ограничивая количество кликов до5. - Агент вызывает функцию
report_searchс сформированным запросом. - Сервер MCP выполняет запрос к базе данных отчетов в режиме реального времени и возвращает строки.
- Агент форматирует результаты в удобную таблицу Markdown.
Подробный список доступных инструментов
Сервер MCP предоставляет вашему агенту следующие инструменты:
| Инструмент MCP | Описание |
|---|---|
get_product_by_name | Получает информацию о товаре для указанного продавца, используя точное имя ресурса товара. Возвращает подробный статус товара, содержащий контекст отчетности и потенциальные проблемы на уровне товара. |
list_products | Выводит список или выполняет поиск нескольких товаров для данного продавца. Возвращает подробную информацию о состоянии товара, включая контекст отчетности и потенциальные проблемы на уровне товара. |
report_search | С помощью запросов к таблицам отчетов можно получать показатели производительности, информацию о статусе продуктов и данные о ценах. Подробности см. в руководстве по отчетам . |
list_data_sources | Перечислите источники данных для данного продавца. |
get_data_source | Получите подробную информацию о конкретном источнике данных. |
create_data_source | Создайте источник данных для указанного продавца. |
fetch_data_source | Получить и обработать файл, связанный с источником данных для конкретного продавца. |
get_file_upload | Получите статус последней загруженной файлы для заданного источника данных. |
list_accounts | Отображение списка учетных записей для данного пользователя. |
list_account_issues | Составьте список проблем на уровне отдельных учетных записей продавцов, чтобы выявить проблемы, затрагивающие всю учетную запись. |
list_programs | Перечислите программы для конкретного продавца, включая штат участия, активные регионы и любые невыполненные требования. |
list_aggregated_product_issues | Составьте список агрегированных проблем на уровне продукта, чтобы отслеживать общее состояние данных о вашем продукте. |
get_automatic_improvements | Настройте автоматическое обновление контента, включая обновления товаров, улучшение изображений и оптимизацию доставки. |