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.txtpython3 -m venv .venv
.venv/bin/pip install -r requirements.txtКлюч
Нужен свой клиент OAuth Google — один раз, около 10 минут:
- Создайте проект в Google Cloud, включите Google Search Console API, настройте экран согласия, опубликуйте приложение и создайте клиент типа Desktop app. Пошагово, с промптом для ИИ-агента, — в статье «Google Search Console API».
- Скачанный JSON переименуйте в
credentials.jsonи положите в папку сервера. - В папке сервера выполните:
.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.
Claude Desktop: Settings → Developer → Edit Config. Cursor: Settings → MCP или файл ~/.cursor/mcp.json. Слеши — прямые.
{
"mcpServers": {
"google-search-console": {
"command": "C:/mcp/google-search-console-mcp/.venv/Scripts/python.exe",
"args": ["C:/mcp/google-search-console-mcp/server.py"]
}
}
}Если в файле уже есть другие серверы, добавьте этот внутрь блока "mcpServers". Claude Desktop перезапустите полностью — через значок в трее.
claude mcp add google-search-console --scope user -- ~/mcp/google-search-console-mcp/.venv/bin/python ~/mcp/google-search-console-mcp/server.pyВ JSON для Claude Desktop и Cursor — те же пути с .venv/bin/python.
Названия пунктов меню у клиентов меняются — сверяйтесь с их документацией.
Проверка
Спросите агента: «Покажи мои сайты в 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_DISABLED | API включён в другом проекте — включите в том, где клиент |
Нет 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, там же общий архив и настройка сразу для всех.