Google Search Console MCP: клики, позиции и индексация для агента

surendranb/google-search-console-mcp· Проверено 12.11.2026· 40на GitHub

Подключает агента к Google Search Console: клики, показы, CTR и позиции по запросам и страницам, сравнение периодов, проверка индексации URL и работа с sitemap.

Как подключить

Что сделать до подключения

uv с командой uvx или Node.js с npx: пакет @surendranb/google-search-console-mcp

Сервисный аккаунт Google с JSON-ключом

Email сервисного аккаунта добавлен пользователем в Search Console → Settings → Users and permissions

GOOGLE_APPLICATION_CREDENTIALS

путь к JSON-ключу: Google Cloud Console → IAM & Admin → Service Accounts → Keys

GSC_SITE_URL

ресурс ровно как в списке Search Console: https://example.com/ со слешем или sc-domain:example.com

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env GSC_SITE_URL=https://example.com/ --env GOOGLE_APPLICATION_CREDENTIALS=/путь/к/service_account.json --transport stdio google-search-console \
  -- uvx google-search-console-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.google-search-console]
command = "uvx"
args = ["google-search-console-mcp"]

[mcp_servers.google-search-console.env]
GSC_SITE_URL = "https://example.com/"
GOOGLE_APPLICATION_CREDENTIALS = "/путь/к/service_account.json"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "google-search-console": {
      "type": "stdio",
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "google-search-console": {
        "type": "local",
        "command": ["uvx", "google-search-console-mcp"],
        "environment": {
          "GSC_SITE_URL": "https://example.com/",
          "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "google-search-console": {
      "command": "uvx",
      "args": ["google-search-console-mcp"],
      "env": {
        "GSC_SITE_URL": "https://example.com/",
        "GOOGLE_APPLICATION_CREDENTIALS": "/путь/к/service_account.json"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_search_analyticsсобирает клики, показы, CTR, позиции

compare_performanceсравнивает два периода

get_data_statusпоказывает дату свежих данных

list_sitesпоказывает ресурсы и права

inspect_urlпроверяет индексацию страницы

get_sitemapsпоказывает отправленные sitemap

submit_sitemapотправляет sitemap

delete_sitemapудаляет sitemap

list_available_dimensionsперечисляет доступные измерения

list_available_metricsперечисляет доступные метрики

skills_listпоказывает SEO-сценарии

skill_readзагружает SEO-сценарий

setup_gsc_accessпомогает исправить настройку доступа

check_for_updatesпроверяет новую версию

Показано 14 из 15.

Что попросить агента

«Какие запросы принесли больше всего кликов на <сайт> за последние 28 дней?»Агент узнает свежую дату через get_data_status и вызовет get_search_analytics с измерением query

«Сравни клики и показы за <месяц> с прошлым месяцем по страницам»Агент вызовет compare_performance с двумя периодами и измерением page

«Проверь, в индексе ли страница <адрес>»Агент вызовет inspect_url и расскажет о статусе индексации, ошибках сканирования и каноническом адресе

«Покажи sitemap сайта и отправь <адрес sitemap.xml>»Агент вызовет get_sitemaps, затем submit_sitemap

«Какие сайты подключены к моей Search Console?»Агент вызовет list_sites и покажет ресурсы с уровнем прав

Для каких задач

Собрать клики, показы, CTR и среднюю позицию по запросам, страницам, странам и устройствам

Сравнить два периода, месяц к месяцу или год к году, с разницей в процентах

Проверить, в индексе ли страница, какие у неё ошибки сканирования и канонический адрес

Посмотреть отправленные sitemap, отправить новый или удалить устаревший

Узнать, за какую дату в Search Console уже есть свежие данные

Ограничения

Доступ только через сервисный аккаунт Google: его email нужно добавить пользователем в каждый ресурс Search Console

Пакет по умолчанию отправляет анонимную телеметрию о вызовах и ошибках; отключается DO_NOT_TRACK=1 или MCP_TELEMETRY_OPT_OUT=1

submit_sitemap и delete_sitemap меняют настройки ресурса в Search Console

skill_read берёт SEO-сценарии с GitHub, без связи — из локальной копии

Если не работает

Сервер пишет, что у сервисного аккаунта нет доступа к ресурсу

В Search Console → Settings → Users and permissions добавьте email client_email из JSON-ключа с правами Full и проверьте, что GSC_SITE_URL совпадает с ресурсом символ в символ.

Google отклоняет JSON-ключ

Ключ повреждён, отозван или это не тот файл: скачайте новый ключ сервисного аккаунта в Google Cloud Console → IAM & Admin → Service Accounts → Keys и укажите путь к нему.

Ответ «does not look like a Search Console property»

Ресурс в GSC_SITE_URL должен начинаться с https:// или с sc-domain:. Скопируйте его из списка ресурсов Search Console.

Ответ «This client can't prompt interactively»

Клиент не умеет задавать вопросы во время настройки: пропишите GOOGLE_APPLICATION_CREDENTIALS и GSC_SITE_URL в env сервера в конфиге клиента и перезапустите клиент.

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

Как дать серверу доступ к моему сайту?

Создайте сервисный аккаунт и JSON-ключ в Google Cloud Console → IAM & Admin → Service Accounts → Keys. Затем в Search Console откройте Settings → Users and permissions и добавьте email из поля client_email ключа: права Full хватит.

Что указать в GSC_SITE_URL?

Ресурс ровно как в списке ресурсов Search Console: https://example.com/ со слешем в конце для ресурса с префиксом URL или sc-domain:example.com для доменного. Это разные ресурсы, и права на них выдаются отдельно.

По каким срезам можно смотреть данные?

get_search_analytics группирует данные по запросу, странице, стране, устройству и дате. Параметр data_state выбирает только окончательные данные (final) или все вместе со свежими (all).

Как отключить телеметрию?

Добавьте в env сервера DO_NOT_TRACK=1 или MCP_TELEMETRY_OPT_OUT=1. Тексты запросов, ключи и переменные окружения в телеметрию не попадают.

Как подключить Search Console MCP к Claude Code?

Выполните claude mcp add google-search-console -- uvx google-search-console-mcp и задайте GOOGLE_APPLICATION_CREDENTIALS и GSC_SITE_URL. Готовые конфиги для других клиентов — во вкладках блока «Как подключить».

Можно запустить Search Console MCP без Python?

Да, сервер опубликован и в npm: npx -y @surendranb/google-search-console-mcp. Переменные те же, что у версии для uvx.

Работает ли сервер из России?

Сервер запускается на вашем компьютере и обращается к API Google Search Console; для ключа сервисного аккаунта нужен проект в Google Cloud Console.