Для чего этот сервер?

Этот MCP-сервер даёт ИИ-агентам и разработчикам полный доступ к Google Search Console и Indexing API. Он решает задачи SEO-аналитики: проверяет поисковые запросы, отправляет URL на индексацию, ищет страницы с ошибками, управляет сайтами и картами сайта. В отличие от других решений, охватывает все endpoint'ы, а не только один метод.

Что он умеет?

Сервер подключает Google Search Console и Indexing API прямо в MCP. Он управляет сайтами и картами сайта, запрашивает поисковую аналитику — показы, клики, CTR и позиции. Проверяет статус индексации, мобильную адаптацию и расширенные результаты любого URL. Отправляет URL на индексацию или удаление, в том числе пачками до 100 штук за раз. Всё, что можно сделать в консоли Google, теперь доступно без ручного входа.

Каталог MCP
mikusnuz/gsc-mcp

mikusnuz/gsc-mcp

от mikusnuz

MCP-сервер для Google Search Console и Indexing API — полный набор инструментов для управления сайтами, картами сайта, аналитики поиска (CTR, позиции) и индексации URL. Полезен SEO-специалистам для...

Github NPM Сайт сервера

README

13 инструментов

Версии

Установить сервер

gsc-mcp

English | 한국어

MCP server for Google Search Console API and Google Indexing API — full API coverage.

When to Use

Task	Tool
"Check which queries my site ranks for"	`search_analytics_query`
"Notify Google about an eligible job posting or livestream URL"	`indexing_publish`
"Find pages with indexing errors"	`url_inspection_inspect`
"Get search performance data for the last 30 days"	`search_analytics_query`
"Compare click-through rates between mobile and desktop"	`search_analytics_query` (group by `device`)
"Submit my sitemap to Google"	`sitemaps_submit`
"Batch notify eligible job posting/livestream URLs"	`indexing_batch_publish`

For AI agents: See llms.txt for a machine-readable summary. Copy templates/CLAUDE.md or templates/AGENTS.md into your project to teach your agent about this MCP.

Unlike other GSC MCP servers that only wrap searchAnalytics.query, this server exposes every endpoint available in the Google Search Console and Indexing APIs.

Часто задаваемые вопросы

Инструменты были проиндексированы: 18.10.2026

indexing_batch_publish

Пакетно уведомляет Google не более чем о 100 подходящих обновлениях или удалениях URL JobPosting или BroadcastEvent. Каждый вложенный ответ проверяется независимо; успешное уведомление не гарантирует индексацию.

Параметры

notificationsobject[]обязательный
Массив подходящих уведомлений URL (от 1 до 100 элементов). Каждый элемент содержит url, contentType и type.

indexing_get_metadata

Получает последние метаданные уведомлений Indexing API для подходящего URL JobPosting или BroadcastEvent. Показывает историю уведомлений, а не то, проиндексировал ли Google URL.

Параметры

contentTypeenumобязательный
Подходящий тип структурированных данных на странице: JobPosting или BroadcastEvent, вложенный в VideoObject
urlstringобязательный
Полный URL-адрес, для которого проверяется статус уведомления.

indexing_publish

Уведомляет Google об обновлении или удалении подходящего URL через Indexing API. Google поддерживает только страницы JobPosting и страницы прямых трансляций с BroadcastEvent, встроенным в VideoObject; это уведомление не гарантирует индексацию.

Параметры

contentTypeenumобязательный
Подходящий тип структурированных данных на странице: JobPosting или BroadcastEvent, встроенный в VideoObject
typeenumобязательный
Тип уведомления: URL_UPDATED или URL_DELETED
urlstringобязательный
Полный URL-адрес, о котором следует уведомить

search_analytics_query

Запрашивает данные о трафике из Google Search Console. Возвращает клики, показы, CTR и данные о позиции с гибкой фильтрацией и группировкой.

Параметры

aggregationTypeenum
Как агрегируются данные (по умолчанию: auto)
dataStateenum
'all' включает свежие (возможно неполные) данные, 'final' только окончательные данные, 'hourly_all' требуется при использовании измерения 'hour'
dimensionFilterGroupsobject[]
Группы фильтров, применяемые к запросу.
dimensionsenum[]
Измерения для группировки: country, device, page, query, searchAppearance, date, hour (hour требует dataState='hourly_all')
endDatestringобязательный
Дата окончания в формате YYYY-MM-DD.
rowLimitnumber
Максимальное количество строк для возврата (1-25000). По умолчанию: 1000
siteUrlstringобязательный
URL сайта
startDatestringобязательный
Дата начала в формате YYYY-MM-DD.
startRownumber
Смещение строки, отсчитываемое от нуля, для пагинации.
typeenum
Фильтр типа поиска: web, image, video, news, discover, googleNews (по умолчанию: web)

sitemaps_delete

Удаляет карту сайта из Google Search Console.

Параметры

feedpathstringобязательный
URL-адрес карты сайта для удаления
siteUrlstringобязательный
URL сайта

sitemaps_get

Получает информацию о конкретном sitemap.

Параметры

feedpathstringобязательный
URL карты сайта (например, 'https://example.com/sitemap.xml')
siteUrlstringобязательный
URL сайта

sitemaps_list

Перечисляет все карты сайта, отправленные для сайта в Google Search Console.

Параметры

sitemapIndexstring
Необязательно: URL индекса sitemap, чтобы перечислить только sitemaps, входящие в этот индекс.
siteUrlstringобязательный
URL сайта

sitemaps_submit

Отправляет карту сайта для сайта в Google Search Console.

Параметры

feedpathstringобязательный
URL карты сайта для отправки (например, 'https://example.com/sitemap.xml')
siteUrlstringобязательный
URL сайта

sites_add

Добавляет сайт (ресурс) в Google Search Console. Верификация может все еще потребоваться.

Параметры

siteUrlstringобязательный
URL сайта для добавления (например, 'https://example.com/' или 'sc-domain:example.com')

sites_delete

Удаляет сайт (ресурс) из Google Search Console.

Параметры

siteUrlstringобязательный
URL сайта для удаления

sites_get

Получает информацию о конкретном сайте (ресурсе) в Google Search Console.

Параметры

siteUrlstringобязательный
URL сайта (например, "https://example.com" или "sc-domain:example.com")

sites_list

Перечисляет все сайты (свойства), к которым у вас есть доступ в Google Search Console.

Параметры

Без параметров.

url_inspection_inspect

Проверяет URL в индексе Google. Возвращает текущий результат URL Inspection API, включая статус индексирования, информацию об обходе, расширенные результаты и статус AMP. Устаревшее поле mobileUsabilityResult может отсутствовать.

Параметры

inspectionUrlstringобязательный
Полный URL для проверки (должен находиться в пределах сайта)
languageCodestring
Необязательный код языка BCP-47 для локализованных результатов (например, 'en-US', 'ko').
siteUrlstringобязательный
URL сайта (свойство), которому принадлежит проверяемый URL.

`1.3.6`основная	19.10.2026
`1.3.5`	19.10.2026
`1.3.4`	08.10.2026
`1.3.3`	06.08.2026
`1.3.2`	04.08.2026
`1.3.1`	19.03.2026
`1.3.0`	18.03.2026
`1.2.0`	18.02.2026
`1.1.0`	17.02.2026

Выберите клиент, чтобы установить mikusnuz/gsc-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"mikusnuz-gsc-mcp-7l2xpwduhu\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@mikusnuz/gsc-mcp\"],\"env\":{\"GSC_CLIENT_ID\":\"your-client-id\",\"GSC_CLIENT_SECRET\":\"your-client-secret\",\"GSC_REFRESH_TOKEN\":\"your-refresh-token\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add mikusnuz-gsc-mcp-7l2xpwduhu --env GSC_CLIENT_ID=your-client-id --env GSC_CLIENT_SECRET=your-client-secret --env GSC_REFRESH_TOKEN=your-refresh-token -- npx -y @mikusnuz/gsc-mcp

Либо через JSON-конфиг:

claude mcp add-json mikusnuz-gsc-mcp-7l2xpwduhu "{\"command\":\"npx\",\"args\":[\"-y\",\"@mikusnuz/gsc-mcp\"],\"env\":{\"GSC_CLIENT_ID\":\"your-client-id\",\"GSC_CLIENT_SECRET\":\"your-client-secret\",\"GSC_REFRESH_TOKEN\":\"your-refresh-token\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add mikusnuz-gsc-mcp-7l2xpwduhu --env GSC_CLIENT_ID=your-client-id --env GSC_CLIENT_SECRET=your-client-secret --env GSC_REFRESH_TOKEN=your-refresh-token -- npx -y @mikusnuz/gsc-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.mikusnuz-gsc-mcp-7l2xpwduhu]
command = "npx"
args = ["-y", "@mikusnuz/gsc-mcp"]

[mcp_servers.mikusnuz-gsc-mcp-7l2xpwduhu.env]
GSC_CLIENT_ID = "your-client-id"
GSC_CLIENT_SECRET = "your-client-secret"
GSC_REFRESH_TOKEN = "your-refresh-token"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите mikusnuz/gsc-mcp, а в поле команды запуска — строку ниже:

npx -y @mikusnuz/gsc-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например mikusnuz-gsc-mcp-7l2xpwduhu.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: mikusnuz-gsc-mcp-7l2xpwduhu
    command: npx
    args:
      - "-y"
      - "@mikusnuz/gsc-mcp"
    env:
      GSC_CLIENT_ID: your-client-id
      GSC_CLIENT_SECRET: your-client-secret
      GSC_REFRESH_TOKEN: your-refresh-token

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "mikusnuz-gsc-mcp-7l2xpwduhu": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/gsc-mcp"
      ],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@mikusnuz/gsc-mcp"
  ],
  "env": {
    "GSC_CLIENT_ID": "your-client-id",
    "GSC_CLIENT_SECRET": "your-client-secret",
    "GSC_REFRESH_TOKEN": "your-refresh-token"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx