Jak połączyć Google Search Console z Claude Code przez MCP

Po co łączyć Search Console z asystentem programistycznym?

Claude Code przydaje się, gdy praca SEO dotyczy samej witryny. W jednym środowisku deweloperskim możesz przeglądać szablony, poprawiać przekierowania, zmieniać tytuły stron, testować build i sprawdzać mapę witryny. Ale Twój kod źródłowy nie powie Ci, która strona straciła w zeszłym tygodniu 300 kliknięć z Google.

Bez dostępu do Search Console asystent może obejrzeć stronę i zaproponować rozsądne zmiany. Nie odróżni jednak problemu o wysokim priorytecie od czegoś, czego nikt nie wyszukuje. Gdy czasu jest mało, ta różnica ma duże znaczenie.

Połączenie MCP dodaje brakujące źródło dowodów. Możesz poprosić Claude Code o wskazanie dotkniętych adresów URL na podstawie Search Console, porównanie ich z lokalnymi szablonami stron i przygotowanie zmian w kodzie opartych na prawdziwym badaniu.

Ten przewodnik dotyczy procesu pracy w terminalu z Claude Code, a nie zwykłego konektora w przeglądarkowej wersji Claude. Jeśli pracujesz głównie w przeglądarce, skorzystaj z naszego przewodnika konfiguracji Claude z Search Console.

Czego potrzebujesz przed uruchomieniem polecenia

Potrzebujesz zainstalowanego i działającego w terminalu Claude Code, konta Google z dostępem do właściwej usługi Search Console oraz serwera MCP, który potrafi pobrać dane tej usługi. Serwer może być hostowany samodzielnie lub zdalny.

Poniższe kroki używają hostowanego endpointu GSC Magic. Według dokumentacji GSC Magic obsługuje on transport Streamable HTTP oraz logowanie przez OAuth lub token dostępu. Twoje konto musi być utworzone, a usługa dostępna; wpisanie poprawnego adresu URL nie oznacza jeszcze, że uwierzytelnianie się powiodło.

Zacznij od sprawdzenia, czy sam Claude Code działa. Otwórz go w zwykłym projekcie i upewnij się, że możesz wpisywać prompty. Nie musisz klonować całej produkcyjnej witryny, żeby przetestować połączenie z Search Console tylko do odczytu.

Zanim się połączysz, zdecyduj, czy praca dotyczy jednej witryny, czy kilku. Łatwo wybrać niewłaściwą usługę Search Console, gdy konto Google ma dostęp do witryn klientów, domen stagingowych i starych usług z prefiksem adresu URL.

Krok 1: dodaj zdalny endpoint MCP

Otwórz terminal i uruchom polecenie:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Oto znaczenie poszczególnych części. claude mcp add rejestruje serwer w Claude Code. Transport http wskazuje zdalną usługę MCP, a nie lokalny program wykonywalny. --scope user udostępnia konektor w konfiguracji na poziomie użytkownika. Krótka nazwa gsc-magic to po prostu identyfikator, który zobaczysz na liście narzędzi.

Adres URL to zdalny endpoint opisany w dokumentacji GSC Magic. To nie jest adres Twojej usługi w Search Console, mapa witryny ani endpoint API Google.

Dlaczego zakres użytkownika? Jeśli prowadzisz prace SEO w wielu lokalnych projektach, połączenie na poziomie użytkownika jest wygodne. W przypadku wspólnego repozytorium lub wrażliwego środowiska klienta przed dodaniem zewnętrznych integracji sprawdź zasady zakresów konfiguracji Claude Code i politykę swojego zespołu.

Ogólne polecenie MCP i wskazówki dotyczące transportu znajdziesz w dokumentacji Claude Code od Anthropic. Zajrzyj tam, jeśli opcja CLI zmieni się w nowszej wersji.

Krok 2: uwierzytelnij się w Claude Code

Uruchom Claude Code i wpisz:

/mcp

Wybierz serwer gsc-magic. Jeśli klient oferuje akcję Authenticate, wykonaj ją i dokończ logowanie w przeglądarce. Użyj konta Google, które ma właściwe uprawnienia do usługi w Search Console.

Nie wysyłaj hasła do Google, kodu autoryzacji OAuth ani tokenu dostępu jako zwykłej wiadomości na czacie. Uwierzytelnianie to osobny krok obsługiwany przez klienta i serwer. Jeśli przeglądarka się otwiera, ale autoryzacja nigdy się nie kończy, wróć do menu MCP i sprawdź stan połączenia, zanim spróbujesz ponownie.

W niektórych środowiskach nie da się dokończyć OAuth w przeglądarce. Wtedy GSC Magic udostępnia osobiste tokeny dostępu w panelu pod Connect → Access tokens. Połączenie z tokenem używa nagłówka, na przykład:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

To szablon, a nie działające dane uwierzytelniające. Podmień symbol zastępczy w bezpiecznym lokalnym procesie konfiguracji i nie zatwierdzaj go w Git. Jeśli potrzebujesz tylko raportów analitycznych i dotyczących indeksowania, utwórz token tylko do odczytu. Dokumentacja platformy wyjaśnia wygasanie tokenów, ich unieważnianie i uprawnienia.

Krok 3: sprawdź, że połączenie działa

Nie zaczynaj od „zrób audyt całej witryny i napraw wszystko”. Poproś o jedną odpowiedź, którą możesz zweryfikować.

Wypisz usługi Google Search Console dostępne w tym połączeniu. Podaj dokładne identyfikatory usług i, jeśli to możliwe, poziomy uprawnień. Nie analizuj żadnej usługi, dopóki jej nie wybiorę.

To sprawdza kilka rzeczy naraz: czy klient wykrywa narzędzia serwera, czy serwer potrafi uwierzytelnić się w Google i czy Twoje konto Google widzi co najmniej jedną usługę.

Wybierz dokładny identyfikator usługi, której potrzebujesz. Usługa zapisana jako sc-domain:example.com może obejmować subdomeny. Usługa z prefiksem adresu URL, taka jak https://www.example.com/, obejmuje węższy zbiór adresów. Niezauważona niezgodność może sprawić, że porównanie ruchu będzie wyglądać źle, mimo że narzędzie działa bez zarzutu.

Jeśli lista jest pusta, najpierw sprawdź konto Google i uprawnienia do usługi. Nie zakładaj, że serwer jest zepsuty.

Krok 4: uruchom pierwsze przydatne porównanie SEO

Dobre pierwsze zadanie jest wąskie, mierzalne i łatwe do powtórzenia:

Dla wybranej usługi Search Console porównaj ostatnie 28 pełnych dni raportowych z poprzednimi 28 dniami. Pokaż dokładne zakresy dat, łączną liczbę kliknięć, wyświetleń i CTR, a potem wypisz dziesięć stron z największą bezwzględną utratą kliknięć. Używaj danych z Search Console, a nie szacunków. Możliwe wyjaśnienia oznacz jako hipotezy.

Ten raport możesz sprawdzić w interfejsie skuteczności w Search Console. Jeśli sumy się różnią, zweryfikuj wybory dotyczące agregacji, strefy czasowe, typy wyszukiwania i to, czy dane są ostateczne. Google liczy kliknięcia i wyświetlenia według własnych definicji raportowania, a nie według zasad sesji GA4.

Potem poproś Claude Code o zagłębienie się w jedną stronę:

Dla adresu URL z największą stratą porównaj dziesięć najważniejszych zapytań między okresami. Pogrupuj istotne zmiany według urządzeń i krajów. Powiedz, które obserwacje uzasadniają zbadanie szablonu strony, a które nie.

Tu asystent programistyczny zaczyna być naprawdę przydatny. Jeśli strona straciła widoczność na urządzeniach mobilnych, możesz przejrzeć nawigację mobilną, układ responsywny i renderowanie. Jeśli straciła wyświetlenia dla wąskiej grupy zapytań, możesz przyjrzeć się treści strony i linkom wewnętrznym. Nie pozwól jednak, by model traktował korelację jak dowód.

Krok 5: połącz dane z kodem swojej witryny

Załóżmy, że Search Console wskazuje ważny adres produktowy ze spadającym współczynnikiem klikalności. Poproś Claude Code o znalezienie trasy lub szablonu odpowiedzialnego za tytuł, opis i nagłówki HTML tej strony.

Rozsądna kolejność wygląda tak:

1. Znajdź stronę lub szablon w swoim projekcie.
2. Sprawdź istniejący tytuł, adres kanoniczny, strukturę nagłówków i główną treść.
3. Odczytaj zapytania, które dały wyświetlenia tej strony.
4. Zaproponuj ograniczoną poprawę zgodną z rzeczywistą treścią strony.
5. Pokaż diff przed wprowadzeniem zmian.
6. Uruchom zwykły build i testy.
7. Zapisz datę wdrożenia, żeby móc później porównać wyniki.

Nie każda strona z niskim CTR potrzebuje nowego tytułu. Może rankować na szerokie zapytania informacyjne z niewielką intencją kliknięcia albo jej średnia pozycja mogła się zmienić. Zanim przepiszesz metadane na podstawie jednej liczby, skorzystaj z poradnika analizy niskiego CTR.

Nigdy nie każ Claude Code usuwać ani przekierowywać stron tylko dlatego, że dwa adresy mają wspólne zapytanie. Może to wyrządzić więcej szkód niż pierwotny problem.

Jak zbudować powtarzalny cotygodniowy proces

Prompt analizy możesz zapisać w notatkach albo w wewnętrznym runbooku projektu. Claude Code nie musi pamiętać poprzedniej rozmowy, jeśli prompt określa parametry raportu.

Za każdym razem proś o te same pełne okna 7- lub 28-dniowe i podawaj wybraną usługę. Niech asystent zwraca tabelę z adresem URL, kliknięciami w każdym okresie, zmianą bezwzględną, zmianą względną i największym wkładem na poziomie zapytań. Pierwszą wersję zostaw tylko do odczytu.

Po raporcie poproś o plan działania ograniczony do trzech pozycji. Dobre zadanie ma zaobserwowany sygnał, jedną proponowaną kontrolę, właściciela i sposób zmierzenia wyniku.

Na przykład: „Strona dokumentacji straciła 120 kliknięć, głównie dla zapytań o konfigurację na desktopie. Sprawdź, czy strona odpowiada na obecną wersję instrukcji integracji; aktualizuj tylko wtedy, gdy treść jest nieaktualna”. To znacznie bardziej konkretne niż „Popraw jakość treści”.

Jeśli planujesz skrypty lub agentów, kontroluj powtarzane wywołania i szanuj limity API Search Console. Cotygodniowy raport nie powinien wymagać setek zduplikowanych żądań.

Rozwiązywanie typowych problemów

Jeśli asystent zgłasza błąd narzędzia, przeczytaj sam błąd, zanim spróbujesz innego promptu. Przeformułowanie zapytania nie naprawi unieważnionego tokenu ani witryny, do której Twoje konto nie ma dostępu.

Dokumentacja Search Analytics API Google opisuje granice dat, wymiary, limity i agregację. Znajomość tych ograniczeń chroni przed zaskakującą liczbą błędnych diagnoz SEO.

Uprawnienia i bezpieczeństwo, gdy kod spotyka dane z wyszukiwarki

Połączenie danych z Search Console z asystentem programistycznym jest potężne, bo asystent może mieć też dostęp do systemu plików. Właśnie dlatego warto rozdzielić badanie od wdrażania.

Narzędzia raportowe traktuj jako tylko do odczytu, kiedy tylko się da. Proś o proponowane diffy kodu i przeglądaj je, zanim asystent cokolwiek zapisze lub wdroży. Korzystaj ze zwykłego procesu Git i kontroli. Jeśli pracujesz z usługami klientów, nie łącz w jednym raporcie danych niepowiązanych klientów.

GSC Magic dokumentuje tokeny tylko do odczytu i osobne ustawienia trybu zapisu. Narzędzia Google Search Console obejmują odczyt analityki i stanu zindeksowanych adresów, natomiast działania administracyjne, takie jak przesłanie mapy witryny, wymagają silniejszego uprawnienia. To rozdzielenie jest ważniejsze niż liczba narzędzi na liście konektora.

Pamiętaj, że URL Inspection API Google nie zgłasza próśb o indeksowanie. Jego wyniki dotyczące wersji zindeksowanej różnią się od testu adresu na żywo. Osobne Google Indexing API obsługuje tylko ograniczone typy treści i nie powinno być skrótem do indeksowania zwykłych stron.

Najczęstsze pytania

Czy Claude Code ma bezpośredni dostęp do Google Search Console bez MCP?

Domyślnie nie. Potrzebna byłaby inna autoryzowana ścieżka, na przykład własny skrypt API lub zaimportowany eksport. MCP to jeden ze standardowych sposobów udostępnienia takich wywołań jako narzędzi, z których Claude Code może korzystać.

Czy to ta sama konfiguracja co w Claude w przeglądarce?

Nie. Claude Code używa konfiguracji MCP zarządzanej przez CLI. Aplikacja webowa Claude ma własny interfejs konektorów. Źródło danych może być takie samo, ale kroki połączenia są inne.

Czy Claude Code może automatycznie naprawiać techniczne problemy SEO?

Może pomagać w edycji plików, do których ma uprawnienia, ale dowody z Search Console nie dowodzą, że każda sugerowana zmiana jest poprawna. Przeglądaj diffy, testuj buildy i wymagaj ludzkiej akceptacji przed wdrożeniem.

Czy agent będzie znał moje konwersje z Google?

Tylko jeśli autoryzujesz odpowiednie źródło analityczne. Search Console raportuje kliknięcia i wyświetlenia w wyszukiwarce; sesje i kluczowe zdarzenia wymagają GA4.

Od jakiego zadania zacząć?

Zacznij od porównania dwóch pełnych okresów 28-dniowych i dziesięciu stron z największymi stratami kliknięć. Te liczby możesz potwierdzić, zanim zaangażujesz jakiekolwiek zmiany w kodzie.

Praktyczny wniosek

Claude Code najlepiej sprawdza się jako pomost między zmierzonym zachowaniem w wyszukiwarce a witryną, którą faktycznie możesz poprawić. Konektor służy do wykrycia problemu, baza kodu do jego zbadania, a zwykły proces przeglądu do bezpiecznego wprowadzenia zmian.

Jeśli potrzebujesz dokładnej, aktualnej listy narzędzi, wariantów tokenów i opcji połączenia, miej dokumentację GSC Magic otwartą podczas konfigurowania klienta. Pomysły na dalszą analizę znajdziesz w naszych 25 promptach dla agentów SEO.