MCP do Google Search Console: SEO-agent w Twoim terminalu (Claude Code lub Codex CLI)

TL;DR

Jak masz ChatGPT Plus, masz w komplecie Codex CLI — terminal-owy agent OpenAI. Jak płacisz za Claude Code — masz jego brata-bliźniaka od Anthropic. Oba mówią w tym samym standardzie zwanym MCP (Model Context Protocol) i oba potrafią rozmawiać z Twoim Google Search Console.

W praktyce: zamiast klikać po panelu GSC, mówisz w terminalu „pokaż mi top 10 zapytań które straciły pozycję w ostatnich 30 dniach dla klient.pl” — i dostajesz odpowiedź z linkami, do skopiowania w raport. To jest post jak to spiąć — krok po kroku, z konfiguracjami dla obu klientów.

Czas instalacji: 15 minut. Z czego 5 minut to klikanie w Google Cloud Console (jednorazowe).

Czym MCP jest, a czym nie jest

MCP to standard, nie produkt. Opracowany przez Anthropic, ale otwarty — wspiera go Claude Code, Claude Desktop app, Codex CLI od OpenAI, plus garść innych klientów. Nie wspiera go ChatGPT (web/desktop app, ten gdzie czatujesz z przeglądarki) — bo tam OpenAI dało inny standard, Custom GPTs + Actions. To nie ten sam mechanizm i nie zadziała.

Co MCP robi: pozwala agentowi (Claude Code, Codex) wywoływać Twoje narzędzia jako tools. Tools = funkcje typu „pobierz dane z GSC”, „wyślij maila przez Gmail”, „dodaj task do Linear”. Agent decyduje sam które tool wywołać na podstawie tego, o co go poprosisz.

Czyli MCP do Google Search Console = agent dostaje 5 funkcji:

1. gsc_list_sites — wszystkie property, które masz w swoim GSC
2. gsc_search_analytics — zapytania, strony, daty, urządzenia, kraje (z filtrami)
3. gsc_inspect_url — URL Inspection API (status indeksu, schema, rich results)
4. gsc_list_sitemaps — submitted sitemaps + status
5. gsc_compare_periods — diff dwóch okresów (świetne do post-deploy SEO check)

I to są wszystkie tools, których agent potrzebuje, żeby zrobić Ci 80% pracy SEO-analityka.

Trzy use case’y, dla których to się opłaca

Audyt klienta w 5 minut

Wchodzi nowy klient. Dostajesz dostęp do GSC. Otwierasz terminal i mówisz:

„Przeskanuj klient.pl w GSC. Pokaż top 20 zapytań po impresjach, top 20 stron po klikach, sprawdź sitemap status, zinspectuj 5 losowych URL-i z bloga pod kątem indeksacji. Zrób raport markdown.”

Agent woła gsc_list_sitemaps, gsc_search_analytics, gsc_inspect_url × 5 — i zwraca Ci raport w 90 sekund. Wklejasz do Notion albo PDF i wysyłasz klientowi.

Post-deploy sanity check

Wgrałeś nową strukturę kategorii sklepu. Wysłałeś nową sitemapę. Tydzień temu. Czy nic nie spadło?

„Porównaj ostatnie 7 dni vs poprzednie 7 dni dla sklep.pl. Pokaż mi URL-e które straciły >20% kliknięć. Sprawdź każdy URL Inspection — czy wszystkie wciąż są w indeksie.”

Agent woła gsc_compare_periods + gsc_inspect_url w pętli. Wraca z listą wątpliwych URL-i. To są kandydaci do ratowania, zanim klient zauważy.

Cannibalization check

Masz dwie strony rankujące na to samo zapytanie, robią sobie konkurencję, żadna nie wskakuje wysoko. GSC tego nie pokazuje wprost (panel pokazuje queries lub pages, nie cross-join).

„Znajdź mi w mojstronia.pl zapytania, dla których ranking ma więcej niż jedną stronę z domeny. Posortuj po sumarycznych impresjach. Pokaż top 20.”

Agent woła gsc_search_analytics z dwoma dimensions (query + page), agreguje sam. To jest robota której ja sam ręcznie zrobiłem 1000x i nigdy się nie polubiłem. Agent w 30s.

Alternatywa: AminForou/mcp-gsc (popularne)

Zanim zaczniesz: w tym terenie jest już popularne rozwiązanie — AminForou/mcp-gsc (842⭐, na PyPI jako mcp-search-console). 15+ tools, comprehensive — batch URL inspection, indexing issues check, performance overview, advanced analytics. Pre-formatted string responses (LLM dostaje gotowy tekst). Świetny wybór jeśli chcesz „wszystko od razu”.

Moje gsc-mcp to niezależna minimalna implementacja z innym focus: 5 essential tools, returns raw dicty (agent sam formatuje), modern Python package structure, explicit OAuth2 + Service Account split. Mniej, ale czysto.

Wybierz świadomie. Reszta postu opisuje setup mojej wersji, ale 90% tego co tu jest (GCP setup, OAuth flow, integracja z Claude Code/Codex CLI) dotyczy też AminForou — tylko nazwy tooli się różnią.

Setup — krok po kroku

Krok 1: Google Cloud Console (5 min, jednorazowe)

1. Wchodzisz na console.cloud.google.com, zalogowany na to samo konto Google, co Twoje GSC.
2. Utwórz projekt (np. „personal-mcp” — nie jest istotny).
3. APIs & Services → Library → Search Console API → Enable.
4. APIs & Services → OAuth consent screen:
   • User Type: External
   • App name: gsc-mcp (cokolwiek)
   • User support email + Developer contact: Twój email
   • Scopes: pomiń, Test users wystarczą
   • Test users: dodaj swój email (ten, którym wchodzisz do GSC)
   • Save
5. APIs & Services → Credentials → + Create Credentials → OAuth client ID:
   • Application type: Desktop app
   • Name: gsc-mcp-desktop
   • Create → ściągnij JSON (przeglądarka pobierze plik client_secret_xxx.json)

To wszystko po stronie Google.

Krok 2: Lokalna instalacja

Potrzebujesz uv (lekki Pythonowy package manager). Jeśli nie masz:

brew install uv

Klonujesz repo gsc-mcp i instalujesz:

git clone https://github.com/stroniarz/gsc-mcp.git ~/Projects/gsc-mcp cd ~/Projects/gsc-mcp uv venv && source .venv/bin/activate uv pip install -e .

Wrzucasz OAuth JSON tam, gdzie go MCP szuka:

mkdir -p ~/.config/gsc-mcp mv ~/Downloads/client_secret_*.json ~/.config/gsc-mcp/oauth-client.json chmod 600 ~/.config/gsc-mcp/oauth-client.json

Pierwszy run otworzy przeglądarkę → wybierz konto Google → „Allow” → token zapisze się do ~/.config/gsc-mcp/oauth-tokens.json i kolejne starty pójdą bez interakcji.

Krok 3a: Wpięcie do Claude Code

// ~/.claude/settings.json {   "mcpServers": {     "gsc": {       "command": "/Users/<you>/Projects/gsc-mcp/.venv/bin/gsc-mcp"     }   } }

Restart Claude Code (zamknij terminal i otwórz znowu, lub /restart w sesji). Sprawdź dostępne tools — powinno być gsc_list_sites, gsc_search_analytics itd.

Krok 3b: Wpięcie do Codex CLI

# ~/.codex/config.toml [mcp_servers.gsc] command = "/Users/<you>/Projects/gsc-mcp/.venv/bin/gsc-mcp"

Restart Codex CLI. Sprawdź przez codex mcp list.

Krok 4: Pierwsze zapytanie

Mów do agenta naturalnie. Próbka:

„Sprawdź, jakie property mam dostępne w GSC.”

Agent zawoła gsc_list_sites, wyrzuci listę. Jeśli widzisz swoje domeny — działa, jedziesz dalej:

„Dla mojadomenacli.pl, pokaż top 10 zapytań po impresjach z ostatnich 28 dni. W tabelce markdown z kolumnami: zapytanie, klikinięcia, impresje, CTR, średnia pozycja.”

I masz raport pod nos.

OAuth vs Service Account — kiedy co

gsc-mcp wspiera oba tryby, ale przy 95% scenariuszy chcesz OAuth user-flow (default):

• OAuth (rekomendowany): jeden login, refresh token żyje miesiącami. Działa dla Domain properties (te które weryfikowałeś przez DNS). Skala: tyle property ile masz dostępu w swoim GSC.
• Service Account (fallback): tworzysz osobne „użytkownik-bot” i dodajesz jego email per-property w GSC ręcznie. Nie działa dla Domain properties (Google to wprost blokuje od kilku miesięcy). Sens tylko jeśli musisz uruchamiać MCP non-interactively (np. cron z scheduled audytami na serwerze, bez przeglądarki).

99% Twojego użycia to OAuth.

Kiedy MCP do GSC NIE ma sensu

Szczerze, bo nie chcę Ci sprzedawać entuzjazmu:

• Robisz SEO dla 1-2 stron: panel GSC jest szybszy niż instalowanie infrastruktury. Wracaj.
• Boisz się terminala: instalacja wymaga uv, OAuth flow, edycja JSON/TOML. Jak Ci to brzmi obco — najpierw zrób podstawowy onboarding w Claude Code (post obok) lub Codex CLI, potem wracaj.
• Masz tylko ChatGPT chat (przez przeglądarkę/desktop app): nie zadziała. MCP wymaga terminalowego klienta. Albo dokup CC, albo zainstaluj Codex CLI (już płacisz przez ChatGPT Plus — patrz niżej).

Jak ja sam to używam (kontekst, nie hype)

Mam 30+ klientów. Comiesięczny raport SEO który kiedyś zajmował 4 godziny per klient — teraz to wywołanie agenta z 5-liniowym promptem i 90 sekund czekania. Łącznie ~3h pracy → ~45 minut. Nie powiem że to zmieniło mi życie — ale dało mi piątkowy wieczór z powrotem.

Jak masz workflow który robisz wielokrotnie i klikasz w te same panele — agent z MCP jest dokładnie do tego. Nie do „SEO na lata”, do automatyzacji wąskiej, powtarzalnej roboty.

Bonus: tydzień Claude Code za darmo

Jeśli nigdy nie próbowałeś Claude Code i chcesz sprawdzić zanim wydasz $20 albo $100 — tu jest mój referral na darmowy tydzień Pro. Tylko trzy pierwsze osoby zadziałają, więc kto pierwszy ten lepszy. Po tygodniu wyłączasz subskrypcję i nie płacisz nic — pełen agent + MCP do GSC do przetestowania na własnej domenie.

Co dalej

Następny post w tej serii: „Jak SEO-wiec może zacząć pracę na Claude Code lub Codex CLI” — onboarding dla ludzi z marketingu, którzy słyszeli „agent AI” i nie wiedzą gdzie kliknąć. Trzy poziomy zaawansowania, decyzyjna tabelka, anti-FOMO sekcja.

Jak chcesz gotowy gsc-mcp repo — github.com/stroniarz/gsc-mcp. Pull request mile widziany; jak masz problem z setupem — wal w issues.