aminforou/mcp-gsc

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

2,1 тыс. stars 270 forks Качество 87 Тренд 45MIT

Repository Install

Google Search Console Insights с Claude AI для SEO

Обзор

Сервер Model Context Protocol (MCP), который соединяет Google Search Console (GSC) с AI-ассистентами, позволяя анализировать ваши SEO-данные через разговоры на естественном языке. Работает с , , , , и любым другим совместимым с MCP клиентом. Более продвинутая хостинговая версия — вход в один клик, добавленные инструменты GA4. Работает с Claude Desktop, Claude Code, Claude.ai, Codex, Cursor и любым MCP-клиентом. Только . → - — удалил блок isatty, который не позволял открыть окно входа в браузер при работе как подпроцесс MCP на macOS. OAuth теперь работает сразу с uvx, без ручного запуска терминала. - — вызовите это, чтобы получить полный список доступных инструментов и текущий статус аутентификации за один раз. Полезно, когда ваш AI-ассистент не уверен, какие инструменты доступны. - — все инструменты теперь точно сообщают, что делать, если учетные данные отсутствуют или истекли.

Обзор (машинный перевод)

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

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

Что нового

[0.4.1] — сентябрь 2026

check_indexing_issues работает одновременно — то же исправление, что и в #31, так что он больше не тайм-аут на 10-URL-пакетах против свойств sc-domain:*. Спасибо @kuldiph. (#55)
Удален оставшийся мёртвый orderBy в get_search_by_page_query (API аналитики поиска игнорирует это). Спасибо @kuldiph. (#55)

[0.4.0] — сентябрь 2026

Проблемы с богатым результатом теперь появляются — inspect_url_enhanced и batch_url_inspection читают проблемы с богатым результатом по правильному пути API, поэтому проблемы с разметкой сообщаются, а не исчезают безмолвно. Спасибо @patrickweh. (#46, #48)

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Google Search Console MCP Server for SEOs

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client.

Skip setup, get more. A more advanced hosted version — one-click sign-in, added GA4 tools. Works with Claude Desktop, Claude Code, Claude.ai, Codex, Cursor, and any MCP client. Only 100 seats. → Advanced GSC MCP (hosted)

What’s New

[0.4.1] — September 2026

check_indexing_issues runs concurrently — same fix as #31, so it no longer times out on 10-URL batches against sc-domain:* properties. Thanks @kuldiph. (#55)
Removed a leftover dead orderBy in get_search_by_page_query (the Search Analytics API ignores it). Thanks @kuldiph. (#55)

[0.4.0] — September 2026

Rich-result issues now surface — inspect_url_enhanced and batch_url_inspection read rich-result issues from the correct API path, so markup problems are reported instead of silently dropped. Thanks @patrickweh. (#46, #48)
batch_url_inspection runs concurrently — 10-URL batches no longer time out on sc-domain:* properties. Thanks @remotesensei. (#31)
compare_search_periods deltas fixed — Period 1 is now the analyzed period and Period 2 the baseline, so growth reads as growth (not decline). Thanks @JKdreaming. (#42)
get_advanced_search_analytics sorting works — sort_by/sort_direction are now applied instead of silently ignored. Thanks @kuldiph. (#54)
Hardened error handling — replaced bare except: clauses so fatal signals aren’t swallowed. Thanks @kuldiph. (#53)
Note: batch_url_inspection renames the per-URL verdict field to index_verdict to distinguish it from the rich-result verdict.

[0.3.3] — July 2026

Fixed fresh installs broken by mcp 2.0 — pinned mcp[cli]<2.0.0. The mcp SDK 2.0.0 (released 2026-07-28) removed the mcp.server.fastmcp module, so every fresh uvx mcp-search-console install crashed on startup with ModuleNotFoundError: No module named 'mcp.server.fastmcp'. New installs now resolve a working 1.x SDK again — no --with "mcp<2" workaround needed.

[0.3.2] — April 2026

OAuth browser flow fixed for uvx — removed the isatty block that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box with uvx, no manual terminal run needed.

Открыть полный README на GitHub

Установка

docker run \

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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