Google Search Console MCP

English | Русский

A1 Google Search Console MCP подключает ИИ-приложение к Google Search Console. Изучайте эффективность в поиске, проверяйте, проиндексирован ли URL-адрес, просматривайте карты сайтов и осознанно отправляйте или удаляйте их, когда это нужно.

Он работает с ресурсами, которые доступны вашей учётной записи Google. Важная деталь: используется точное значение ресурса Search Console — доменный ресурс и ресурс с префиксом URL — это разные объекты.

• 12 инструментов. Семь инструментов читают ресурсы, поисковые данные, карты сайтов и статус индексации; два добавляют ресурс или отправляют карту сайта; три могут удалять данные или вызывать произвольный метод API.

• Точные идентификаторы ресурсов. https://example.com/, https://www.example.com/ и sc-domain:example.com — это разные значения. list_sites покажет, какое значение использовать.

• Поисковые данные в контексте. Запросы кликов, показы, CTR и позиция по дате, странице, запросу, стране, устройнику или типу поиска.

• Индексация, а не публикация. Проверка URL-адреса объясняет текущий статус Google; она не принудительно добавляет страницу в индекс.

Начните с вопроса, который ничего не меняет:

Покажи 20 лучших поисковых запросов по моему ресурсу за последние 28 дней, с кликами и CTR.

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

Проверьте работу за минуту

Вы: Проиндексирован ли https://example.com/pricing? Если нет, почему?

Ассистент: Проверяет URL-адрес и показывает вердикт об индексации, покрытии, данные об обходе и канонические URL. Ничего не меняется.

Вы: Проверь мои отправленные карты сайтов и подготовь повторную отправку для той, где есть ошибки.

Ассистент: Показывает карту сайта, её предупреждения и ошибки, а затем спрашивает подтверждение перед повторной отправкой.

Вы: Подтверждаю.

Ассистент: Повторно отправляет выбранную карту сайта. Он не меняет содержимое страниц и не гарантирует индексацию.

Related MCP server: mcp-gsc

Содержание

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

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

• Как устроены ресурсы Search Console

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

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

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

• Данные, лимиты и фоновая работа

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

• Поддержка

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

Вам понадобятся Node.js 20+, учётная запись Google с доступом к ресурсу Search Console и учётные данные OAuth от Google Cloud.

1. Подоруйте OAuth-доступ.

2. Добавьте сервер своё ИИ-приложение.

3. Начните с того же вопроса выше — он ничего не изменяет.

В приложении: откройте Settings → Plugins → MCP servers, выберите Add server, затем укажите npx -y mcp-google-search-console@latest с GOOGLE_SEARCH_CONSOLE_CLIENT_ID, GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET и GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN.

codex mcp add google-search-console \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-search-console@latest
codex mcp list

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

claude mcp add \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_ID=your_client_id \
  --env GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

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

Откройте Settings → Developer → Edit Config и добавьте:

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

Если пункт Edit Config недоступен, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

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

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

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"your_client_id","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"your_client_secret","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"your_refresh_token"}}}}

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

Запустите MCP: Open User Configuration и добавьте:

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"],"env":{"GOOGLE_SEARCH_CONSOLE_CLIENT_ID":"${input:gsc_client_id}","GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET":"${input:gsc_client_secret}","GOOGLE_SEARCH_CONSOLE_REFRESH_TOKEN":"${input:gsc_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gsc_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gsc_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gsc_refresh_token","description":"Google OAuth refresh token","password":true}]}

Проверьте с помощью MCP: List Servers. Документация MCP для VS Code

Что можно попросить его сделать

Найти возможности для поиска

• Какие запросы и страницы принесли больше всего кликов в этом месяце?

• Какие страницы потеряли клики по сравнению с прошлым периодом?

• Покажи запросы, содержащие mcp, где средняя позиция ниже 10.

Проверять статус индексации и карты сайтов

• Индексируется ли этот URL? Покажи покрытие, обход и канонические данные.

• В каких отправленных картах сайтов есть ошибки или предупреждения?

• Отправь эту карту заново после показа её текущего статуса.

Аккуратно управлять ресурсами

• Список ресурсов Search Console, к которым я имею доступ.

• Добавьте это точное значение ресурса; я проверю владение отдельно.

• Удалите этот ресурс из аккаунта после подтверждения.

Как устроены ресурсы Search Console

Ресурс с префиксом URL должен содержать протокол и завершающий слэш, например, https://example.com/. Домен учитывается как sc-domain:example.com. Признака не совпадения может дать ошибку 403 или 404. Гог909999, поэтому используйте точное значение, которое возвращает list_sites.

add_site только регистрирует ресурс. Проверка выполняется в интерфейсе Search Console или через Site Verification API. Поисковые данные используют тихоокеанское время; end_date включена в диапазон, и окончательные данные аналитики обычно отстают на два-три дня. data_state: "all" может включать в себя свежи–е и всё ещё изменяющиеся строки.

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

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

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

Для доступа к данным Search Console нужен Google OAuth 2.0; одного API-ключа недостаточно.

1. Создайте или выберите проект Google Cloud и включите Google Search Console API.

2. Настройте экран согласия OAuth и создайте тест/при oauth с типом Desktop application.

3. Используйте OAuth 2.0 Playground с параметром Use your own OAuth credentials, чтобы авторизовать учётную запись Google, у которой есть доступ к ресурсам, и получить токен обновления.

4. Используйте https://www.googleapis.com/auth/webmasters — он даёт доступ к картам сайтов и изменению ресурсов. Используйте https://www.googleapis.com/auth/webmasters.readonly только в том случае, если вам осознанно нужен режим только для чтения.

Токены обновления в тестовом режиме могут истекать через семь дней. Для долгосрочного доступа опубликуйте OAuth-приложение или используйте внутреннее приложение Workspace. Относитесь к клиентскому секрету и токену обновления как к паролям.

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

* Укажите либо три OAuth-поля, либо токен доступа.

Данные, лимиты и фоновая работа

• Приватность. Локальный сервер обращается к Google и отправляет анонимную телеметрию с идентификатором установки, версиями и именами инструментов — никогда не передаёт OAuth-токены, данные ресурсов, аргументы инструментов и ваши запросы.

• Лимиты API. URL-инспекция допускает 2000 проверок на ресурс в день и 600 проверок в минуту. Аналитику выдают не более 25 000 строк за один запрос; хвостовые анонимизированные запросы никогда не возвращаются. Используйте пагинацию и не проверяйте весь сайт URL-адрес за URL-адресом.

• Никакого фонового мониторинга. Сервер работает только когда к нему обращаются. Если ваше ИИ-приложение поддерживает планировщик, оно может периодически проверять карту сайта или важный URL.

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

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

• Все инструменты и все аргументы

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

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

• Google Search Console API

Поддержка

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