Google Search Console MCP Server для SEO-специалистов

Сервер Model Context Protocol (MCP), который подключает Google Search Console (GSC) к ИИ-ассистентам, позволяя анализировать ваши SEO-данные с помощью естественного языка. Работает с Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity и любым другим MCP-совместимым клиентом.

Пропустите настройку, получите больше. Более продвинутая хостинговая версия — вход в один клик, добавлены инструменты GA4. Работает с Claude Desktop, Claude Code, Claude.ai, Codex, Cursor и любым MCP-клиентом. Всего 100 мест. → Advanced GSC MCP (хостинговая версия)

Что нового

[0.3.3] — июль 2026

• Исправлена установка с нуля, сломанная mcp 2.0 — закреплена версия mcp[cli]<2.0.0. SDK mcp 2.0.0 (выпущен 2026-07-28) удалил модуль mcp.server.fastmcp, поэтому каждая новая установка uvx mcp-search-console падала при запуске с ошибкой ModuleNotFoundError: No module named 'mcp.server.fastmcp'. Теперь новые установки снова получают рабочую версию SDK 1.x — обходной путь --with "mcp<2" больше не нужен.

[0.3.2] — апрель 2026

• Исправлен OAuth-браузерный поток для uvx — удалён блок isatty, который мешал открытию окна входа в браузере при запуске в качестве MCP-подпроцесса на macOS. OAuth теперь работает из коробки с uvx, ручной запуск в терминале не требуется.

• Добавлен инструмент get_capabilities — вызовите его, чтобы получить полный список доступных инструментов и текущий статус авторизации одним запросом. Полезно, когда ваш ИИ-ассистент не уверен, какие инструменты доступны.

• Улучшены сообщения об ошибках авторизации — все инструменты теперь точно говорят, что делать, если учётные данные отсутствуют или истекли.

Related MCP server: Google Search Console MCP Server

Что это умеет?

Управление свойствами

• Просматривайте все свои свойства GSC в одном месте

• Получайте данные о проверке и информацию о владельце

• Добавляйте или удаляйте свойства из аккаунта

Аналитика поиска и отчёты

• Узнавайте, какие запросы приводят посетителей на ваш сайт

• Отслеживайте показы, клики и рейтинг кликов (CTR)

• Анализируйте тенденции производительности и сравнивайте периоды

• Визуализируйте данные с помощью графиков, созданных вашим ИИ-ассистентом

Проверка URL и индексация

• Проверяйте, есть ли у конкретных страниц проблемы с индексацией

• Узнавайте, когда Google в последний раз сканировал ваши страницы

• Проверяйте несколько URL одновременно для выявления закономерностей

Управление картами сайта

• Просматривайте все карты сайта и их статус

• Отправляйте новые карты сайта

• Проверяйте наличие ошибок или предупреждений

Доступные инструменты

Попросите вашего ИИ-ассистента «вызвать get_capabilities», чтобы получить полный список всех 20 инструментов.

Начало работы

Шаг 1 — Настройка учётных данных Google API

Вам нужны учётные данные перед настройкой любого клиента. Выберите один из способов:

Вариант A — OAuth (рекомендуется — использует ваш собственный аккаунт Google)

1. Перейдите в Google Cloud Console и создайте или выберите проект

2. Включите Search Console API

3. Перейдите в Credentials → Создать учётные данные → OAuth client ID

4. Настройте экран согласия OAuth, выберите Desktop app, нажмите «Создать»

5. Скачайте JSON-файл — сохраните его в постоянном месте (например, ~/Documents/client_secrets.json)

При первом использовании откроется окно браузера с запросом входа в ваш аккаунт Google. После этого токен сохраняется, и повторное взаимодействие с браузером не требуется.

Вариант B — Сервисный аккаунт (для автоматизации или командного использования)

1. Перейдите в Google Cloud Console и создайте или выберите проект

2. Включите Search Console API

3. Перейдите в Credentials → Создать учётные данные → Service Account

4. Перейдите на вкладку «Ключи» → Добавить ключ → Создать новый ключ → JSON → Скачать

5. Сохраните файл в постоянном месте (например, ~/Documents/service_account.json)

6. Добавьте email сервисного аккаунта в ваше свойство GSC: Search Console → Настройки → Пользователи и разрешения → Добавить пользователя → Полный доступ

🎥 Посмотрите пошаговое видео по настройке этого раздела

Обновлено в 2026 году — охватывает весь процесс установки с использованием нового метода uvx, от настройки учётных данных Google до первого успешного запроса.

Шаг 2 — Установка

Вариант A — uvx (рекомендуется)

Никакого клонирования, установки Python или виртуальных окружений. uvx автоматически скачивает и запускает сервер и поддерживает его в актуальном состоянии.

Установите uv — откройте Терминал и выполните все три команды по порядку:

# 1. Download and install
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activate in the current Terminal session
source $HOME/.local/bin/env

# 3. Make it permanent for all future sessions
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

Проверка:

uv --version

Зачем все три команды? Установщик помещает uv в ~/.local/bin, но ваша уже открытая сессия Терминала ещё не знает об этой папке. Шаг 2 активирует её немедленно. Шаг 3 гарантирует, что в каждом будущем окне Терминала она будет доступна автоматически.

Теперь настройте ваш ИИ-клиент:

Claude Desktop

Файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Сервисный аккаунт:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Cursor

Файл конфигурации: ~/.cursor/mcp.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Codex CLI

Файл конфигурации: ~/.codex/config.toml

OAuth:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

Сервисный аккаунт:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_CREDENTIALS_PATH = "/full/path/to/service_account.json", GSC_SKIP_OAUTH = "true" }

Поиск пути к uvx: На macOS/Linux выполните which uvx в Терминале после установки uv (обычно /Users/YOUR_NAME/.local/bin/uvx). На Windows выполните Get-Command uvx | Select-Object -ExpandProperty Source в PowerShell (или where uvx в cmd) — обычно это C:\Users\YOUR_NAME\.local\bin\uvx.exe. Замените /FULL/PATH/TO/uvx в конфигурациях выше на этот путь.

Зачем полный путь? GUI-приложения, такие как Claude Desktop и Cursor, запускаются без чтения вашего конфигурационного файла оболочки (~/.zshrc), поэтому они не знают о ~/.local/bin. Использование полного пути гарантирует работу независимо от способа запуска приложения. Если вы видите ошибку spawn uvx ENOENT, это решение.

После сохранения конфигурации полностью закройте приложение (Cmd+Q) и откройте его снова.

Для OAuth: при первом использовании окно браузера откроется автоматически для входа. После этого токен кэшируется, и вас больше не будут спрашивать.

Вариант B — Клонирование (продвинутый)

Предпочитаете видеоинструкцию для этого метода? Приведённое ниже руководство шаг за шагом описывает путь установки через клонирование — настройка виртуального окружения, зависимости и конфигурация:

Используйте этот вариант, если хотите изменить код или запустить конкретную локальную версию. Этот метод использует видеоинструкцию выше для шагов настройки учётных данных.

Требуется Python 3.11+. Этот сервер не запустится на Python 3.10 или старше — и при запуске через GUI-клиент, такой как Claude Desktop, он молча завершается (инструменты не появляются и файл журнала не создаётся). Проверьте свою версию с помощью python --version. Если она ниже 3.11, установите Python 3.11 или новее и пересоздайте виртуальное окружение. Метод uvx (вариант A) полностью избегает этой проблемы, управляя версией Python за вас, поэтому он рекомендуется на Windows.

Клонируйте репозиторий:

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc

Или скачайте ZIP-архив с зелёной кнопки Code в верхней части этой страницы и распакуйте его.

Настройте окружение:

uv venv .venv
uv pip install -r requirements.txt

Настройте ваш ИИ-клиент (пример для Claude Desktop):

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Сервисный аккаунт:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Примеры путей для Mac:

• Python: /Users/yourname/Documents/mcp-gsc/.venv/bin/python

• Скрипт: /Users/yourname/Documents/mcp-gsc/gsc_server.py

Шаг 3 — Тестирование

Спросите вашего ИИ-ассистента: «Список моих свойств GSC»

Если вы видите свои свойства — всё работает. Если нет, спросите: «Вызови get_capabilities», чтобы увидеть статус авторизации и диагностировать проблему.

Справочник переменных окружения

Cursor Marketplace

Доступна установка в один клик — найдите mcp-search-console в Cursor Marketplace.

После установки настройте свои учетные данные (см. Шаг 1 выше), затем используйте встроенные навыки непосредственно в чате Cursor Agent:

Примеры запросов

Устранение неполадок

spawn uvx ENOENT или command not found: uvx

Ваш ИИ-клиент не может найти uvx. Используйте полный путь вместо просто uvx:

# Find your full path (macOS/Linux):
which uvx
# Typically: /Users/YOUR_NAME/.local/bin/uvx

# Find your full path (Windows PowerShell):
Get-Command uvx | Select-Object -ExpandProperty Source
# Typically: C:\Users\YOUR_NAME\.local\bin\uvx.exe

Замените "command": "uvx" на полный путь (например, "command": "/Users/YOUR_NAME/.local/bin/uvx") в вашей конфигурации.

uv --version выдает "command not found" сразу после установки

Установщик обновляет ~/.local/bin, но ваша текущая сессия Terminal еще не видит его. Выполните:

source $HOME/.local/bin/env

Затем добавьте его навсегда:

echo 'source $HOME/.local/bin/env' >> ~/.zshrc

Ошибка аутентификации / файл учетных данных не найден

Убедитесь, что вы используете абсолютный путь к файлу учетных данных — не относительный путь, не ~/. Пример:

/Users/yourname/Documents/client_secrets.json   ✅
~/Documents/client_secrets.json                 ✅
client_secrets.json                              ❌

MCP работает только в приложении Claude Desktop, а не на сайте

Сервер MCP работает локально на вашем компьютере. Он работает только в приложении Claude Desktop (скачанном с claude.ai/download), а не в браузерном интерфейсе claude.ai.

Проблемы с конфигурацией ИИ-клиента

1. Убедитесь, что все пути к файлам в вашей конфигурации являются правильными абсолютными путями

2. Полностью выйдите (Cmd+Q) и снова откройте приложение после любого изменения конфигурации — просто закрытие окна недостаточно

3. Попросите вашего ИИ-ассистента «вызвать get_capabilities» — он сообщит точный статус аутентификации и ошибку

Безопасность: разрушительные операции

По умолчанию add_site, delete_site и delete_sitemap отключены. Чтобы включить их:

"GSC_ALLOW_DESTRUCTIVE": "true"

Удаленное развертывание и Docker (продвинутый уровень)

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

HTTP-транспорт

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=3001 python gsc_server.py

Docker

docker build -t mcp-gsc .

docker run \
  -e MCP_TRANSPORT=sse \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

Связанные инструменты

Advanced GSC Visualizer — Расширение для Chrome (14 000+ пользователей) с интерактивными графиками, экспортом до 25 000 строк в один клик, обнаружением каннибализации ключевых слов и ИИ-ассистентом — все прямо внутри Google Search Console. Создано тем же автором. Установить из Chrome Web Store →

Вклад в проект

Нашли ошибку или есть идея по улучшению? Откройте issue или отправьте pull request на GitHub.

Лицензия

Лицензия MIT. Подробности см. в файле LICENSE.

Журнал изменений

[0.3.3] — июль 2026

• Закреплена версия mcp[cli]>=1.3.0,<2.0.0. SDK mcp 2.0.0 удалил mcp.server.fastmcp, что ломало все свежие установки uvx с ошибкой ModuleNotFoundError. Ограничение ниже 2.0 восстанавливает рабочие установки. (Исправляет #41)

[0.3.2] — апрель 2026

• Исправлен поток браузера OAuth для uvx — удален блок isatty, который мешал открытию окна браузера OAuth при запуске в качестве подпроцесса MCP на macOS. OAuth + uvx теперь работает из коробки.

• Инструмент get_capabilities — возвращает все доступные инструменты, сгруппированные по категориям, плюс текущий статус аутентификации одним вызовом.

• Улучшенные сообщения об ошибках аутентификации — все инструменты теперь явно сообщают о необходимости вызвать reauthenticate, когда учетные данные отсутствуют или истекли.

• Улучшено описание list_properties — лучшее семантическое обнаружение инструментов в клиентах, использующих ленивую загрузку инструментов.

[0.3.1] — апрель 2026

• Исправлено маскирование реальных ошибок аутентификации в list_properties; быстрый отказ при отсутствии учетных данных.

[0.3.0] — апрель 2026

• Плагин Cursor Marketplace с 4 встроенными SEO-навыками

• Стабильное хранение токенов в каталоге конфигурации пользователя платформы (переживает обновления uvx)

• Структурированный JSON-вывод для всех инструментов данных

• 39 модульных тестов

[0.2.2] — апрель 2026

• Режим безопасности для разрушительных инструментов (отключен по умолчанию)

• HTTP/SSE-транспорт для удаленных развертываний

• Dockerfile

[0.2.1] — март 2026

• Инструмент reauthenticate для переключения учетных записей Google

• Исправлен сбой TypeError при работе с картой сайта

• Исправлены ошибки 404 для свойств домена

[0.2.0] — март 2026

• dataState: "all" по умолчанию (соответствует панели GSC)

• Гибкий параметр row_limit (до 500)

• Многомерная фильтрация для расширенной аналитики

[0.1.0] — Первоначальный выпуск

• 19 инструментов, охватывающих управление свойствами, аналитику поиска, проверку URL и управление картами сайта

• Аутентификация OAuth и сервисного аккаунта