Telegram Обсудить проект
MCP · бесплатно · только чтение

MCP-сервер Google Search Console

Подключает Google Search Console к Claude, Cursor и другим ИИ-агентам: агент сам выгружает запросы, страницы, CTR и позиции, проверяет индексацию адресов и файлы Sitemap.

Версия 1.0.0 · Python 3.10+ · лицензия MIT

Коротко

MCP-сервер Google Search Console — программа на Python, через которую ИИ-агент читает данные Search Console по вашему клиенту OAuth: запросы, страницы, страны, устройства и даты с кликами, показами, CTR и позицией, файлы Sitemap и проверку индексации URL. Работает на вашем компьютере, только чтение, бесплатно.

Что умеет

ИнструментЧто даётПример вопроса
gsc_list_sitesресурсы аккаунта и уровень доступа«Какие сайты у меня в Search Console?»
gsc_search_analyticsклики, показы, CTR, позиция по запросам, страницам, странам, устройствам, датам; фильтры«Какие страницы потеряли клики в октябре по сравнению с сентябрём?»
gsc_list_sitemapsфайлы Sitemap, дата обработки, ошибки«Есть ли ошибки в файлах Sitemap?»
gsc_url_inspectстатус индексации URL, дата сканирования, канонический адрес«Проверь, в индексе ли эти 10 адресов и какой канонический выбрал Google»

Агент сам выбирает инструмент и параметры — достаточно спросить обычными словами.

Установка

1. Python 3.10 или новее — python.org/downloads. На Windows отметьте при установке Add python.exe to PATH.

2. Архив. Скачайте google-search-console-mcp.zip и распакуйте, например, в C:\mcp. Откройте папку google-search-console-mcp, в адресной строке Проводника наберите powershell и нажмите Enter.

3. Зависимости:

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Ключ

Нужен свой клиент OAuth Google — один раз, около 10 минут:

  1. Создайте проект в Google Cloud, включите Google Search Console API, настройте экран согласия, опубликуйте приложение и создайте клиент типа Desktop app. Пошагово, с промптом для ИИ-агента, — в статье «Google Search Console API».
  2. Скачанный JSON переименуйте в credentials.json и положите в папку сервера.
  3. В папке сервера выполните:
.venv\Scripts\python auth_setup.py

Откроется браузер: войдите в Google, на экране «Приложение не проверено» нажмите Дополнительно → Перейти, разрешите просмотр данных Search Console. Появится файл gsc_token.json — дальше сервер обновляет доступ сам. Права — только чтение (webmasters.readonly).

Если приложение оставить в статусе Testing, Google отзовёт доступ через 7 дней — поэтому его нужно опубликовать.

Подключение к агенту

Пути замените на свои.

claude mcp add google-search-console --scope user -- "C:\mcp\google-search-console-mcp\.venv\Scripts\python.exe" "C:\mcp\google-search-console-mcp\server.py"

Проверка: claude mcp list — статус Connected.

Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.

Проверка

Спросите агента: «Покажи мои сайты в Search Console и топ-10 запросов по кликам за прошлый месяц для первого». Если агент ответил данными — всё работает. Если пишет, что инструмента нет, — проверьте путь: команда .venv\Scripts\python server.py в папке сервера должна молча «зависнуть» (это норма, выход Ctrl+C).

Необязательные настройки

Все — в файле .env, по одной на строку.

НастройкаЗачем
GSC_DEFAULT_SITEресурс по умолчанию, точно как в списке сайтов: sc-domain:example.ru или https://example.ru/
GSC_ALLOWED_SITESограничить агента этими ресурсами через запятую
GSC_CREDENTIALS_PATH, GSC_TOKEN_PATHсвои пути к файлам — для нескольких Google-аккаунтов
HTTP_TIMEOUTтаймаут, по умолчанию 60 секунд
HTTPS_PROXYпрокси, если API Google недоступен напрямую

Частые ошибки

Что видитеЧто делать
access_deniedприложение в статусе Testing — опубликуйте его и запустите auth_setup.py заново
invalid_grantудалите gsc_token.json и снова запустите auth_setup.py
SERVICE_DISABLEDAPI включён в другом проекте — включите в том, где клиент
Нет credentials.jsonположите JSON клиента в папку сервера под этим именем

Не пересылайте никому файлы .env, credentials.json и gsc_token.json — это доступ к данным ваших сайтов. Вопросы и ошибки — в Telegram-канал @seo_drift.

Чего не умеет

  • Только чтение: отправка Sitemap и запрос индексирования не делаются.
  • Позиция — средняя по показам, данные с задержкой 2–3 дня и за 16 месяцев.
  • Проверка URL — до 2000 адресов в сутки на сайт (лимит Google).

Какие данные собирает

Сервер работает у вас на компьютере. Ключ лежит в папке сервера и уходит только в официальный API. SEO Drift не видит ни ключа, ни данных ваших сайтов.

Вопросы и ответы

Это бесплатно?

Да. Сервер бесплатный, с открытым кодом под лицензией MIT, API тоже бесплатный.

С какими агентами работает?

С любым клиентом MCP, который запускает локальные серверы: Claude Code, Claude Desktop, Cursor и другие.

Может ли сервер что-то изменить в кабинете?

Нет, все инструменты только читают данные.

Где остальные серверы?

Все три сервера — Вебмастер, Метрика и Search Console — на странице MCP-серверы для SEO, там же общий архив и настройка сразу для всех.

Читать дальше по теме

Источники

  1. Google for Developers — Search Console API
  2. Google for Developers — Search Console API: usage limits

Другие инструменты

Все инструменты →