mcp-gsc

Часть набора открытых SEO-инструментов DigestSEO.

• Продукт: digestseo.com/gsc-mcp

• Поддержка: digestseo.com/support

• Конфиденциальность: digestseo.com/privacy

Самозапускаемый лаунчер доступен как @digestseo/mcp-gsc:

npx -y @digestseo/mcp-gsc

Для настройки развертывания Google OAuth и Cloudflare следуйте SETUP.md.

Подключение за 30 секунд

Каждый развернутый экземпляр предоставляет одинаковую форму конечной точки:

https://<your-worker>.workers.dev/mcp

Экземпляр, размещенный на DigestSEO, доступен по адресу:

https://mcp-gsc.digestseo.com/mcp

Claude Code

claude mcp add --transport http gsc https://<your-worker>.workers.dev/mcp

ChatGPT — добавьте его как пользовательский коннектор; см. Подключение в вашем AI-клиенте ниже.

Самозапускаемый сервер Model Context Protocol (MCP) для Google Search Console. Подключите его к Claude.ai, Cursor, ChatGPT или любому MCP-совместимому клиенту и спрашивайте вашего AI-ассистента о органической поисковой производительности вашего сайта — показах, кликах, топ-запросах, статусе индексации и состоянии карты сайта — прямо из вашего собственного аккаунта Google.

Он работает на Cloudflare Workers и поставляется с одношаговой настройкой Google OAuth: подключите сервер в вашем клиенте, один раз войдите в Google, предоставьте запрошенные разрешения Google Search Console — и готово. Никаких API-ключей для копирования и никакого JSON сервисного аккаунта для управления.

Предпочитаете нулевую настройку? Хостинговая версия — с автоматическими еженедельными email-дайджестами, доставляемыми на ваш почтовый ящик, — находится на digestseo.com. Этот репозиторий — открытое ядро, которое вы можете запустить самостоятельно.

Инструменты

По умолчанию (GSC_ACCESS_MODE=readwrite) этот сервер предоставляет 17 инструментов. Инструменты аналитики и отчетности только для чтения помечены readOnlyHint MCP; инструменты записи ниже могут изменять свойства Search Console, карты сайта или состояние индексации. Установите GSC_ACCESS_MODE=readonly, чтобы запросить только область Search Console только для чтения и предоставить 12 инструментов только для чтения.

Режим чтения-записи запрашивает области Google Search Console чтения-записи и Indexing API. Режим только для чтения запрашивает только https://www.googleapis.com/auth/webmasters.readonly (плюс openid и email) и не регистрирует пять инструментов записи. Чтение-запись остается по умолчанию, чтобы существующие развертывания сохраняли текущее поведение; см. SETUP.md, чтобы выбрать режим перед подключением пользователей.

Право на использование indexing.request. Indexing API Google не является универсальным инструментом отправки страниц — на момент написания документации Google ограничивает его двумя типами контента: страницами со структурированными данными JobPosting и страницами прямых трансляций со структурированными данными BroadcastEvent, вложенными в VideoObject. Перед отправкой сервер загружает целевой URL и проверяет его JSON-LD на наличие одного из этих двух типов; если ни одного нет (или страницу не удалось загрузить), он возвращает ошибку с объяснением, почему URL не подходит, вместо вызова Indexing API. Успешная отправка — это лишь подтверждение того, что Google получил уведомление — она не гарантирует индексацию URL.

Related MCP server: gsc-mcp

Что вы можете спросить

После подключения вы можете спросить вашего ассистента, например:

• "Какие мои топ-20 запросов по кликам за последние 28 дней?"

• "Сравните показы для example.com в этом месяце и в прошлом — какие страницы упали?"

• "Индексируется ли https://example.com/pricing? Когда он был просканирован в последний раз?"

• "По каким запросам мой блог занимает позиции 5–15? Это мои быстрые победы."

• "Дай мне еженедельный дайджест для sc-domain:example.com заканчивающийся сегодня."

• "Есть ли в моих картах сайта ошибки или предупреждения?"

• "Раздели мои клики на брендовые и небрендовые, используя регулярное выражение по запросу."

• "Как мой сайт показывает себя в Google Discover по сравнению с обычным веб-поиском?"

Подключение в вашем AI-клиенте

После развертывания сервера (см. SETUP.md) подключите его, вставив URL /mcp вашего Worker в ваш клиент:

https://<your-worker>.workers.dev/mcp

• Claude.ai — Настройки → Коннекторы → Добавить пользовательский коннектор → вставьте URL /mcp. Оставьте Client ID и Client Secret пустыми. При первом использовании Claude открывает поток входа в Google; предоставьте доступ, запрошенный развертыванием, и коннектор станет зеленым.

• Cursor — добавьте его как пользовательский MCP-сервер, указывающий на тот же URL /mcp.

• ChatGPT (с поддержкой коннекторов/MCP) — добавьте пользовательский коннектор с URL /mcp.

Любой MCP-совместимый клиент работает — все они указывают на одну и ту же конечную точку /mcp и используют один и тот же поток OAuth.

Настройка

Самостоятельное размещение означает использование собственных учетных данных Google OAuth и аккаунта Cloudflare. Полное пошаговое руководство, которое можно скопировать и вставить, находится в SETUP.md — включая важное примечание о проверке OAuth Google и 7-дневном ограничении refresh-токена, пока ваше приложение не проверено.

Краткая схема:

git clone https://github.com/<you>/mcp-gsc.git
cd mcp-gsc
npm install
cp wrangler.example.jsonc wrangler.jsonc       # then paste in your KV ids
# set GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET / TOKEN_ENCRYPTION_KEY as secrets
# choose GSC_ACCESS_MODE=readonly in wrangler.jsonc for a read-only deployment
npm run deploy

См. SETUP.md для подробного описания каждого шага.

Разработка

npm install
npm test              # typecheck + offline unit tests (what CI runs)
npm run dev           # wrangler dev (local)
npm run test:smoke    # structural smoke tests against a deployment

Приветствуются вклады — см. CONTRIBUTING.md.

Лицензия

MIT © 2026 DigestSEO.

Создано и поддерживается Tomi Šeregi, создателем digestseo.com — еженедельные SEO-дайджесты для нетехнических владельцев сайтов.