/ Каталог / Песочница / mcp-gsc
← Все серверы ↗ GitHub
● Сообщество AminForou ⚡ Сразу

mcp-gsc

автор AminForou · AminForou/mcp-gsc

Pull Google Search Console data into Claude — 20 tools for search analytics, URL inspection, sitemaps. Perfect for SEO triage and reporting.

mcp-gsc (AminForou) connects Google Search Console to AI assistants. 20 tools cover property management, search analytics with filtering/comparison, URL inspection (indexing status), and sitemap submission/monitoring. Auth via OAuth (personal) or service account (team).

▶ Смотреть демо 📦 Установить 💡 Сценарии

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

gsc.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gsc",
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "gsc": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-gsc"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add gsc -- uvx mcp-gsc

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: mcp-gsc

Generate a weekly SEO report with mcp-gsc

👤 SEO managers, content teams ⏱ ~15 min beginner

Когда использовать: Monday morning — you want last week's performance summary before standup.

Предварительные требования
  • GSC access to the property — search.google.com/search-console
  • OAuth credentials or service account — console.cloud.google.com — enable Search Console API
Поток
  1. Pull top queries + deltas
    For acme.com, top 20 queries last week vs the previous week. Show clicks, CTR, position deltas.✓ Скопировано
    → Delta table
  2. Pull top landing pages movers
    Top 10 pages with the biggest clicks changes (up or down).✓ Скопировано
    → Winners + losers list
  3. Draft the summary
    Write a 5-bullet summary for the team meeting, with an action item for the biggest loser.✓ Скопировано
    → Ready-to-paste report

Итог: Monday report in 10 minutes.

Сочетать с: google-sheets

Audit indexing issues across your site

👤 Technical SEOs ⏱ ~30 min intermediate

Когда использовать: Traffic dipped and you want to know if Google is still indexing what it should.

Поток
  1. Sample top pages
    From top 50 landing pages last month, inspect each URL's indexing status via inspect_url_enhanced.✓ Скопировано
    → Per-URL status: indexed/crawled-not-indexed/excluded
  2. Cluster issues
    Group by issue type. For 'crawled but not indexed', what's the common pattern?✓ Скопировано
    → Diagnosis by cluster

Итог: Prioritized fix list tied to real GSC verdicts.

Verify sitemap health and submission status

👤 Anyone launching new pages ⏱ ~10 min beginner

Когда использовать: You just launched new pages — check Google picked up the sitemap.

Поток
  1. List sitemaps
    get_sitemaps for acme.com. Show last-read dates and error counts.✓ Скопировано
    → Sitemap health list
  2. Resubmit stale ones
    For sitemaps not read in 7 days, resubmit.✓ Скопировано
    → Submitted

Итог: Confidence that Google sees the new content.

Mine GSC for ranking opportunities

👤 Growth-stage SEOs ⏱ ~40 min intermediate

Когда использовать: You want queries where you rank 11-20 and are close to page 1.

Поток
  1. Find near-miss queries
    Queries last 90 days with avg position between 11 and 20 AND >100 impressions. Return with the landing page.✓ Скопировано
    → Target list
  2. Prioritize by effort
    For top 20, check the landing page — is it already optimized for the query? If not, suggest on-page changes.✓ Скопировано
    → Effort-weighted opportunity list

Итог: A prioritized SEO backlog grounded in your real GSC data.

Сочетать с: firecrawl

Комбинации

Сочетайте с другими MCP — эффект x10

gsc + google-sheets

Automated weekly SEO report dropped into a shared sheet

Every Monday, run my weekly SEO report and append to 'SEO Weekly' sheet.✓ Скопировано
gsc + firecrawl

Scrape competitor pages ranking for your target queries

For each near-miss query in GSC, find the top SERP pages (via firecrawl), and summarize why they outrank me.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
list_properties Discover what you have access to 1 API call
get_search_analytics site, start_date, end_date, dimensions[], filters?, row_limit? The workhorse query 1 API call
inspect_url_enhanced site, url Per-URL indexing debug 1 API call
get_sitemaps site Sitemap health 1 API call
submit_sitemap site, feedpath Nudge Google to recrawl 1 API call

Стоимость и лимиты

Во что обходится

Квота API
GSC API: 1200 QPM per project, 6000 QPD per site
Токенов на вызов
Analytics results up to 25k rows per call — chunk before dumping
Деньги
Free
Совет
Use row_limit and filters; dumping top-10k queries ruins context for agents

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: https://www.googleapis.com/auth/webmasters.readonly
Хранение учётных данных: GSC_OAUTH_CLIENT_SECRETS_FILE or GSC_CREDENTIALS_PATH in env
Исходящий трафик: searchconsole.googleapis.com
Никогда не давайте: webmasters (full)

Устранение неполадок

Частые ошибки и исправления

403 User does not have permission

OAuth'd account or service account must be verified user in GSC for that property. Add under Settings → Users

Empty analytics response

GSC has 2-3 day data lag; end_date > today - 3 may be empty. Also: 'Web' vs 'Discover' search types differ

OAuth flow loops

Redirect URI in client_secrets.json must match exactly (including http://localhost port)

Альтернативы

mcp-gsc в сравнении

АльтернативаКогда использоватьКомпромисс
GSC web UIAd hoc manual workNo automation, no reporting loop
Ahrefs/SEMrush APIsYou want third-party rank tracking, not Google's own dataPaid; different dataset

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills