Google Search Console MCP — MCP-сервер для Claude Code
MCP-сервер с доступом только на чтение к Google Search Console: свойства, Search Analytics, карты сайта, инспекция URL. Пригодится, когда агент должен смотреть поисковые данные прямо в проекте.
claude mcp add --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GSC_LOG_LEVEL=<GSC_LOG_LEVEL> --transport stdio google-search-console-mcp -- uvx scalably-gsc-mcpЧто делает Google Search Console MCP
Сервер отдаёт пять инструментов: gsc_list_sites перечисляет свойства, доступные сервисному аккаунту, gsc_query_search_analytics ходит в Search Analytics с фильтрами и почасовыми данными, gsc_list_sitemaps читает карты сайта, gsc_inspect_url смотрит статус индексации одного адреса, gsc_batch_inspect_urls прогоняет пачку адресов с ограничением частоты запросов на стороне клиента.
Ответ каждого инструмента — JSON с полями status, operation, summary, target, result, proof, warnings, recovery. Статус partial вместе с proof.nextStartRow означает, что выборку надо продолжать с этой строки. Так обходится лимит Google в 25 000 строк на один вызов Search Analytics: сервер листает дальше сам до max_rows.
Заранее нужен проект в Google Cloud с включённым Search Console API и сервисный аккаунт с JSON-ключом. Этот аккаунт придётся добавить пользователем в каждое свойство Search Console — прав «полный» или «ограниченный» хватает. Путь к ключу задаёт переменная GOOGLE_APPLICATION_CREDENTIALS, без неё сервер данные не получит. Инспекция URL у Google ограничена 600 запросами в минуту и 2 000 в сутки на свойство, а сервер считает дневную квоту только внутри одного вызова и советует вести счёт самостоятельно.
Какие задачи решает
- посмотреть, какие поисковые запросы приводят трафик на сайт
- выгрузить данные Search Analytics глубже лимита в 25 000 строк
- проверить, попала ли страница в индекс
- прогнать пачку адресов через инспекцию URL без упора в квоту
- показать агенту список карт сайта по свойству
Примеры запросов агенту
- Перечисли свойства Search Console, которые видит сервисный аккаунт
- Выгрузи запросы по свойству за прошлую неделю с фильтром по странице
- Проверь индексацию адресов из
urls.txtпачкой
Как установить Google Search Console MCP
Командой платформы
claude mcp add --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GSC_LOG_LEVEL=<GSC_LOG_LEVEL> --transport stdio google-search-console-mcp -- uvx scalably-gsc-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-gsc-mcp <команда>
Командой платформы
codex mcp add google-search-console-mcp --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GSC_LOG_LEVEL=<GSC_LOG_LEVEL> -- uvx scalably-gsc-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-gsc-mcp <команда>
Файл настроек
{
"mcpServers": {
"google-search-console-mcp": {
"command": "uvx",
"args": [
"scalably-gsc-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
"GSC_LOG_LEVEL": "<GSC_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-gsc-mcp <команда>
Файл настроек
{
"servers": {
"google-search-console-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"scalably-gsc-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
"GSC_LOG_LEVEL": "<GSC_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-gsc-mcp <команда>
Командой платформы
gemini mcp add -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -e GSC_LOG_LEVEL=<GSC_LOG_LEVEL> google-search-console-mcp uvx scalably-gsc-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-gsc-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Search Console MCP
Как установить Google Search Console MCP в Claude Code?
Одной командой: claude mcp add gsc-mcp -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -- uvx scalably-gsc-mcp. Вместо плейсхолдера подставьте путь к JSON-ключу сервисного аккаунта.
Что делает Google Search Console MCP?
Даёт агенту доступ на чтение к Search Console: свойства, Search Analytics, карты сайта, инспекция одного URL и пачки URL. Запись и изменение настроек сервер не делает.
Что нужно подготовить перед запуском?
Включить Google Search Console API в проекте Google Cloud, создать сервисный аккаунт и скачать его JSON-ключ. Почту этого аккаунта добавьте пользователем в каждое свойство, которое хотите читать.
