Google Search Console MCP Server — поисковая аналитика, индексация URL и управление картами сайта для ИИ-ассистентов (SEO / LLMO)

mcp-server-gsc — это MCP-сервер (Model Context Protocol) для Google Search Console, который подключает ваши данные о поисковой производительности к Claude или любому MCP-клиенту. Он позволяет ИИ-ассистентам запрашивать поисковую аналитику (клики, показы, CTR, позицию), проверять статус индексации и сканирования URL, а также управлять картами сайта — так вы можете анализировать и оптимизировать SEO и LLMO вашего сайта прямо в диалоге.

Инструменты

Related MCP server: Google Search Console MCP Server

Настройка

1. Сборка

npm install
npm run build

2. Учётные данные Google Cloud

Вам нужен проект Google Cloud с включённым Search Console API (console.cloud.google.com → API и сервисы → Библиотека → «Google Search Console API» → Включить).

Затем выберите один из двух способов авторизации:

Вариант A — OAuth (рекомендуется: вход с собственным аккаунтом Google)

1. API и сервисы → Учётные данные → Создать учётные данные → Идентификатор клиента OAuth → Тип приложения Настольное приложение.

2. При появлении запроса сначала настройте экран согласия OAuth (подойдёт тип «Внешний»; добавьте свой аккаунт Google как тестового пользователя).

3. Скачайте JSON клиента или скопируйте идентификатор клиента и секрет.

Настройте через переменные окружения — либо:

GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com
GSC_OAUTH_CLIENT_SECRET=GOCSPX-...

либо укажите путь к скачанному JSON:

GSC_OAUTH_CREDENTIALS=/path/to/client_secret_xxxx.json

При первом вызове инструмента (или через инструмент reauthenticate) откроется окно браузера для входа в Google. Токены хранятся в ~/.config/mcp-server-gsc/tokens.json и обновляются автоматически.

Вариант Б — Сервисный аккаунт (без браузера)

1. API и сервисы → Учётные данные → Создать учётные данные → Сервисный аккаунт, затем создайте JSON-ключ.

2. В Search Console → Настройки → Пользователи и разрешения, добавьте email сервисного аккаунта как пользователя на каждое свойство.

GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

Если задан GOOGLE_APPLICATION_CREDENTIALS, он имеет приоритет, и вход в браузере не используется.

3. Регистрация в вашем MCP-клиенте

Claude Code:

claude mcp add gsc \
  -e GSC_OAUTH_CLIENT_ID=xxxx.apps.googleusercontent.com \
  -e GSC_OAUTH_CLIENT_SECRET=GOCSPX-... \
  -- node /path/to/mcp-server-gsc/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/path/to/mcp-server-gsc/dist/index.js"],
      "env": {
        "GSC_OAUTH_CLIENT_ID": "xxxx.apps.googleusercontent.com",
        "GSC_OAUTH_CLIENT_SECRET": "GOCSPX-..."
      }
    }
  }
}

Рекомендуемые дополнительные инструменты для SEO / LLMO

Этот сервер лучше всего использовать для SEO / LLMO в сочетании с:

• KeywordGraph MCP server — позволяет сравнивать ваши данные Search Console с данными о поисковых намерениях в реальном времени, проводить анализ тематических кластеров и строить графы знаний ваших запросов и контента. Подключайтесь напрямую через https://mcp.keywordgraph.com, например:

  claude mcp add --transport http keywordgraph https://mcp.keywordgraph.com

• SEO skill — добавляет расширенные рабочие процессы SEO / LLMO поверх обоих серверов.

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

Примечания по использованию

• Формат URL сайта важен: доменные свойства — sc-domain:example.com; свойства с префиксом URL — https://example.com/ (точно как показано в Search Console). Используйте list_properties, чтобы увидеть свои.

• Задержка данных: данные аналитики Search Console отстают примерно на 2 дня. Когда вы используете сокращение days вместо явных дат, окно автоматически заканчивается 2 дня назад.

• Периоды времени: инструменты аналитики принимают либо явные startDate/endDate (YYYY-MM-DD), либо счётчик days (по умолчанию 28).

• Смена аккаунтов: вызовите инструмент reauthenticate — он отбрасывает сохранённые токены и заново открывает вход в браузере.

• Расположение хранилища токенов можно переопределить с помощью GSC_CONFIG_DIR.

Разработка

npm run watch   # recompile on change

Структура исходников:

• src/index.ts — MCP-сервер и определения инструментов

• src/auth.ts — OAuth loopback-поток, хранение токенов, поддержка сервисных аккаунтов

• src/gsc.ts — вспомогательные функции Search Console API (запросы, итоги, диагностика проверки URL)