Jak budować własne raporty SEO z Claude Code i Google Search Console?

Nowy kierunek raportowania SEO polega na odejściu od sztywnych dashboardów na rzecz interaktywnych, szytych pod pytanie raportów generowanych z danych Google Search Console. Search Engine Land pokazuje workflow, w którym Claude Code działa jak lokalny asystent raportowy: czyta pliki, skrypty i dane GSC, generuje wykresy, segmentacje i podsumowania, a SEO może zadawać pytania typu: „które strony zyskały ruch?”, „które zapytania non-brand spadają?” albo „jak CTR różni się między urządzeniami?”. Największa wartość: po jednorazowej konfiguracji raporty można tworzyć dynamicznie, zamiast budować osobny dashboard na każdą rozmowę z klientem lub zarządem.

1. Dlaczego klasyczne raportowanie SEO przestaje wystarczać?

Przez lata raport SEO oznaczał najczęściej: eksport z Google Search Console, czyszczenie danych w Excelu lub Google Sheets, wykresy w Looker Studio i ręczne przygotowywanie komentarzy do spotkania. Ten model nadal działa, ale jest sztywny. Dobrze odpowiada na pytania, które przewidzieliśmy wcześniej, ale gorzej radzi sobie z pytaniami zadanymi w trakcie spotkania: „a jak wygląda tylko mobile?”, „a co z non-brand?”, „a które URL-e spadły mimo wzrostu impresji?”. Search Engine Land opisuje ten problem jako napięcie między szybkością dashboardów a elastycznością własnej analizy.

Claude Code zmienia ten model, bo nie jest zwykłym chatbotem w przeglądarce. To narzędzie agentowe pracujące lokalnie, które może operować na folderach, plikach, skryptach, eksportach CSV, arkuszach i szablonach raportów. Dzięki temu raport SEO zaczyna przypominać mały projekt analityczny, a nie ręcznie składany dokument.

2. Czym właściwie jest Claude Code w kontekście SEO?

Claude Code to agenticzne narzędzie programistyczne Anthropic, które może czytać projekt, edytować pliki, uruchamiać komendy i integrować się z narzędziami developerskimi. Oficjalna dokumentacja opisuje je jako asystenta działającego w terminalu, IDE, aplikacji desktopowej i przeglądarce.

W SEO oznacza to praktycznie, że Claude Code może stać się lokalnym SEO Command Center. Może pomóc przygotować skrypt do pobierania danych z Google Search Console API, przetworzyć CSV z GSC, stworzyć wykres, wygenerować tabelę spadków, przygotować porównanie miesiąc do miesiąca lub rok do roku i zbudować gotowy raport HTML / Markdown / PDF. Search Engine Land podkreśla, że po konfiguracji środowiska użytkownik może zadawać pytania o dane i tworzyć niestandardowe widoki raportowe w minutach, zamiast ręcznie przebudowywać dashboard.

3. Trzy poziomy wdrożenia

Poziom 1: eksport CSV z Google Search Console

To najprostszy wariant. Pobierasz dane z GSC ręcznie jako CSV, zapisujesz w folderze projektu i prosisz Claude Code o analizę. Nie trzeba od razu łączyć API. To dobry start dla małej strony, agencji lub testowego projektu.

Przykładowe polecenie do Claude Code:

W folderze /data mam eksporty CSV z Google Search Console. Przeanalizuj dane z ostatnich 90 dni, porównaj je z poprzednimi 90 dniami i przygotuj raport: strony rosnące, strony spadające, zapytania z wysokimi impresjami i niskim CTR, oraz rekomendacje treściowe.

Poziom 2: połączenie z Search Console API

To wariant średniozaawansowany. Google Search Console API pozwala pytać o dane ruchu z Google Search z filtrami i wymiarami, takimi jak data, kraj, urządzenie, strona i zapytanie. Oficjalna metoda searchanalytics.query wymaga zakresu dat i zwraca dane pogrupowane według wskazanych wymiarów.

Ten wariant pozwala budować raporty automatyczne: np. „pobierz dane z ostatnich 28 dni”, „porównaj z poprzednim okresem”, „zapisz wynik do CSV”, „wygeneruj wykres i komentarz”.

Poziom 3: BigQuery Bulk Export

To wariant dla większych serwisów. Google umożliwia codzienny eksport danych Search Console do BigQuery. W dokumentacji Google wskazuje, że bulk export pozwala zaplanować codzienny eksport danych wydajności GSC do BigQuery, gdzie można wykonywać złożone zapytania i eksportować dane dalej; wyjątkiem są zapytania anonimowe.

To najlepsza opcja dla dużych serwisów contentowych, e-commerce, marketplace’ów i portali, gdzie interfejs GSC albo zwykłe eksporty nie wystarczają. Google Cloud podkreśla, że BigQuery daje możliwość głębszej analizy ruchu z Google Search i tworzenia własnych raportów na większych zbiorach danych.

4. Co można raportować lepiej niż w klasycznym dashboardzie?

1. Strony rosnące i spadające

Przykładowe pytanie:

Pokaż 20 landing pages, które najbardziej zyskały kliknięcia w ostatnich 28 dniach względem poprzednich 28 dni. Dodaj impresje, CTR, średnią pozycję i komentarz, co mogło wpłynąć na zmianę.

To raport dla spotkania zarządu, marketingu lub content teamu.

2. Zapytania z wysokimi impresjami i niskim CTR

Przykładowe pytanie:

Znajdź zapytania, które mają ponad 1000 impresji, średnią pozycję 3–12 i CTR niższy niż średnia dla tej pozycji. Podziel je według landing page i zaproponuj poprawki title/meta oraz sekcji Short Answer.

To raport pod szybkie optymalizacje snippetów i treści.

3. Spadki non-brand

Przykładowe pytanie:

Oddziel zapytania brandowe od non-brandowych. Pokaż największe spadki non-brand w ostatnich 90 dniach i pogrupuj je według intencji: informacyjna, porównawcza, transakcyjna, lokalna.

To szczególnie ważne w analizie wpływu AI Overviews, AI Mode i zmian SERP na ruch organiczny.

4. CTR według urządzeń

Przykładowe pytanie:

Porównaj CTR mobile vs desktop dla najważniejszych 50 zapytań. Pokaż przypadki, gdzie mobile CTR jest znacznie słabszy mimo podobnej pozycji.

Search Engine Land podaje przykłady raportów generowanych z Claude Code, m.in. porównania CTR według urządzeń, top landing pages i spadających zapytań non-brand.

5. Heatmapa zapytań i miesięcy

Przykładowe pytanie:

Zbuduj heatmapę: zapytania w wierszach, miesiące w kolumnach, metryka: kliknięcia albo średnia pozycja. Pokaż, które tematy sezonowo rosną i spadają.

Search Engine Land wskazuje, że w takim modelu można tworzyć scorecardy, wykresy czasowe, porównania rok do roku i heatmapy pokazujące czynniki stojące za zmianą metryk.

5. Minimalna architektura projektu

Najprostszy folder projektu może wyglądać tak:

seo-reporting/
├── data/
│   ├── gsc_export_last_90_days.csv
│   ├── gsc_export_previous_90_days.csv
│   └── brand_terms.txt
├── scripts/
│   ├── clean_gsc_data.py
│   ├── compare_periods.py
│   └── generate_charts.py
├── reports/
│   ├── seo-report-2026-05.html
│   └── seo-report-2026-05.md
├── charts/
│   ├── top_pages_growth.png
│   ├── ctr_opportunities.png
│   └── query_heatmap.png
└── CLAUDE.md

Plik CLAUDE.md jest bardzo przydatny, bo można w nim zapisać zasady pracy dla agenta: czym jest projekt, jak liczyć brand/non-brand, jakie domeny analizować, jakich komend nie uruchamiać i jak ma wyglądać raport. Badania nad konfiguracjami Claude Code pokazują, że manifesty agentów często zawierają komendy operacyjne, notatki techniczne i opis architektury projektu — czyli dokładnie te elementy, które pomagają agentowi działać spójnie w kolejnych sesjach.

6. Przykładowy plik CLAUDE.md dla SEO

# SEO Reporting Project — GEOknows

## Cel projektu
Tworzymy cykliczne raporty SEO z danych Google Search Console dla domeny klienta.

## Zasady analizy
- Zawsze rozdzielaj brand i non-brand.
- Brand terms znajdują się w pliku data/brand_terms.txt.
- Porównuj okresy 28 vs 28 dni oraz 90 vs 90 dni.
- Pokazuj kliknięcia, impresje, CTR i średnią pozycję.
- Nie wyciągaj wniosków bez danych.
- Oznaczaj hipotezy jako hipotezy.

## Format raportu
1. Executive Summary
2. Największe wzrosty
3. Największe spadki
4. Szanse CTR
5. Szanse contentowe
6. Zapytania non-brand
7. Rekomendacje 7/30/90 dni
8. Aneks danych

## Bezpieczeństwo
- Nie usuwaj plików bez potwierdzenia.
- Nie nadpisuj raportów bez kopii.
- Nie publikuj danych.
- Nie wysyłaj plików poza lokalny projekt.

To jest ważne, bo Claude Code ma dostęp do plików i może wykonywać działania projektowe. Oficjalna dokumentacja opisuje mechanizmy uprawnień typu allow/ask/deny, a reguły deny mają pierwszeństwo przed ask i allow.

7. Dane z Google Search Console: co trzeba wiedzieć?

Search Console API nie zawsze zwraca wszystkie wiersze

Google w dokumentacji searchanalytics.query wskazuje, że API jest ograniczone wewnętrznymi limitami Search Console i nie gwarantuje zwrotu wszystkich wierszy — zwraca raczej topowe wyniki. Wyniki są sortowane malejąco według liczby kliknięć.

To oznacza, że raport z API jest świetny do bieżącej analizy, ale przy dużych stronach trzeba uważać na interpretację danych long-tail.

Limit 50 tys. wierszy dziennie na typ wyszukiwania

Google w dokumentacji „Getting your performance data” wskazuje, że Search Analytics API udostępnia maksymalnie 50 tys. wierszy danych dziennie dla każdego typu wyszukiwania, np. web, image czy video.

Dlatego przy dużych serwisach lepiej rozważyć BigQuery Bulk Export.

FAQ Search Appearance będzie deprecjonowane w API

W dokumentacji Search Console API pojawia się ważna informacja: od 7 maja 2026 roku FAQ rich results nie pojawiają się już w Google Search, a wsparcie dla FAQ search appearance w Search Console API ma być wycofane w sierpniu 2026.

Dla GEOknows to ważne rozróżnienie: FAQ nadal może być użyteczne dla AEO, AI Search, UX i struktury treści, ale nie należy obiecywać efektu w postaci FAQ rich results w klasycznym Google.

8. Looker Studio, Search Console Insights czy Claude Code?

Looker Studio

Looker Studio jest dobre do powtarzalnych dashboardów. Google opisuje konektor Search Console jako sposób na mierzenie i analizowanie wyników strony w Google Search oraz łączenie danych z innymi źródłami, np. Google Analytics i Google Ads.

Najlepsze zastosowanie: stały dashboard miesięczny lub raport dla klienta.

Search Console Insights

Search Console Insights to uproszczony raport w samym Search Console. Google opisuje go jako prosty przegląd kluczowych metryk i zmian ruchu, pomocny dla właścicieli stron, którzy nie muszą być ekspertami od danych.

Najlepsze zastosowanie: szybka kontrola trendów i ogólny przegląd.

Claude Code

Claude Code jest najlepszy, kiedy potrzebujesz odpowiedzi na niestandardowe pytanie: segmentacja, filtr, porównanie, wykres, analiza spadku, komentarz dla zarządu albo dynamiczne pytanie podczas spotkania. Search Engine Land podkreśla, że dashboardy są szybkie, ale sztywne, a Claude Code daje elastyczność budowania nowych widoków raportowych w odpowiedzi na bieżące pytania.

9. Praktyczny workflow: od danych do raportu

Krok 1: Ustal cel raportu

Nie zaczynaj od danych. Zacznij od pytania biznesowego.

Przykłady:

Czy ruch organiczny spada przez utratę pozycji, CTR czy popyt?
Które strony mają największy potencjał wzrostu?
Czy non-brand rośnie szybciej niż brand?
Które treści wymagają aktualizacji?
Czy content hub buduje widoczność?
Czy strony produktowe mają rosnące impresje, ale niski CTR?
Czy AI/zero-click zmniejsza liczbę kliknięć przy rosnących impresjach?

Krok 2: Przygotuj dane

Minimum:

GSC: query, page, date, country, device, clicks, impressions, CTR, position.
Lista brand terms.
Lista URL-i strategicznych.
Opcjonalnie: GA4 conversions / leads / events.
Opcjonalnie: adnotacje zmian na stronie.

Google wskazuje, że Search Console pokazuje, które zapytania prowadzą użytkowników do strony oraz umożliwia analizę kliknięć, impresji i pozycji w Google Search.

Krok 3: Zbuduj skrypt lub użyj CSV

Wersja prosta:

Przeanalizuj plik CSV z GSC. Usuń wiersze bez zapytań. Podziel dane na brand i non-brand według pliku brand_terms.txt. Następnie przygotuj tabelę największych wzrostów i spadków.

Wersja API:

Napisz skrypt Python, który pobiera z Google Search Console API dane dla domeny sc-domain:example.com z ostatnich 28 dni, z wymiarami query, page, device i country. Zapisz wynik do CSV.

Krok 4: Generuj widoki

Przykładowe widoki:

scorecard: clicks, impressions, CTR, avg position,
top 10 growth pages,
top 10 declining pages,
non-brand query losses,
CTR opportunities,
pages with rising impressions and falling clicks,
device split,
country split,
content hub performance,
cannibalization candidates,
query-to-page mismatch.

Krok 5: Dodaj warstwę interpretacji

Raport bez interpretacji to tylko tabela.

Dobra struktura komentarza:

Co się stało?
Dlaczego to mogło się stać?
Jak bardzo to jest istotne?
Które URL-e / zapytania są najważniejsze?
Co robimy w 7 dni?
Co robimy w 30 dni?
Co testujemy w kolejnym cyklu?

Krok 6: Zapisz raport jako artefakt

Formaty:

Markdown — szybki raport do edycji.
HTML — dobra wersja do prezentacji.
CSV — aneks danych.
PNG/SVG — wykresy.
PDF — wersja finalna dla klienta lub zarządu.

10. Gotowe prompty do Claude Code

Prompt 1: szybki raport miesięczny

Masz dostęp do danych Google Search Console w folderze /data. 
Przygotuj miesięczny raport SEO za ostatnie 28 dni vs poprzednie 28 dni.

W raporcie pokaż:
1. Executive Summary.
2. Zmianę kliknięć, impresji, CTR i średniej pozycji.
3. Top 10 stron rosnących.
4. Top 10 stron spadających.
5. Top 20 zapytań non-brand ze spadkiem kliknięć.
6. Zapytania z wysokimi impresjami i niskim CTR.
7. Rekomendacje działań na 7, 30 i 90 dni.

Zapisz raport jako reports/monthly-seo-report.md i przygotuj wykresy w folderze /charts.

Prompt 2: analiza CTR

Przeanalizuj dane GSC i znajdź zapytania, które mają:
- minimum 500 impresji,
- średnią pozycję od 2 do 12,
- CTR niższy niż mediana dla podobnej pozycji.

Pogrupuj wyniki według landing page. 
Dla każdej strony zaproponuj nowy title, meta description i sekcję Short Answer.

Prompt 3: analiza spadków

Znajdź strony, które straciły najwięcej kliknięć w ostatnich 90 dniach względem poprzednich 90 dni.

Dla każdej strony pokaż:
- utracone kliknięcia,
- zmianę impresji,
- zmianę CTR,
- zmianę pozycji,
- główne zapytania odpowiadające za spadek,
- hipotezę przyczyny,
- rekomendację optymalizacji.

Prompt 4: AI Search / GEO lens

Na podstawie danych GSC znajdź tematy, gdzie impresje rosną, ale kliknięcia i CTR spadają. 
Oznacz je jako potencjalnie narażone na zero-click, AI Overviews lub zmianę SERP.
Dla każdego tematu zaproponuj:
- aktualizację treści,
- sekcję FAQ,
- sekcję Short Answer,
- pomysł na listicle,
- pytania do przetestowania w ChatGPT, Perplexity i Google AI Mode.

Prompt 5: raport dla zarządu

Przygotuj raport dla zarządu, bez technicznego żargonu.

Skup się na:
- co wzrosło,
- co spadło,
- gdzie tracimy szanse,
- które działania mogą przynieść szybki efekt,
- które projekty wymagają większej pracy,
- jakie decyzje biznesowe trzeba podjąć.

Maksymalnie 2 strony.

11. Raporty, które warto zbudować w GEOknows

1. Raport „SEO Pulse”

Cotygodniowy raport zmian:

największe wzrosty,
największe spadki,
szybkie alerty,
URL-e wymagające uwagi,
nowe zapytania.

2. Raport „CTR Opportunity”

Raport pod optymalizację tytułów, meta opisów i sekcji otwierających:

dużo impresji,
niska klikalność,
pozycje 2–12,
propozycje zmian.

3. Raport „Content Decay”

Raport starzenia się treści:

strony tracące kliknięcia,
strony z malejącymi impresjami,
stare artykuły z potencjałem,
rekomendowana aktualizacja.

4. Raport „GEO / AEO Readiness”

Raport łączący dane GSC z checklistą treści answer-ready:

czy strona ma Short Answer,
czy ma FAQ,
czy ma aktualną datę,
czy ma autora,
czy zawiera porównania,
czy odpowiada na pytania fan-out,
czy może być cytowana przez AI.

5. Raport „Query Fan-Out Opportunities”

Raport pokazujący, które zapytania można rozwinąć w klastry treści:

główna fraza,
pytania poboczne,
typ intencji,
obecny URL,
brakująca sekcja,
rekomendowany content.

12. Ważne zasady bezpieczeństwa

Claude Code może działać na plikach i uruchamiać komendy. Oficjalna dokumentacja opisuje możliwość konfigurowania reguł uprawnień oraz trybów pracy, a niezależne badania nad Claude Code zwracają uwagę, że agenticzne narzędzia kodujące mają systemy uprawnień, ale wymagają rozsądnych ograniczeń i świadomej konfiguracji.

Dobre praktyki:

pracuj na kopii danych,
nie umieszczaj kluczy API w plikach widocznych publicznie,
używaj .env i nie commituj go do repozytorium,
oddziel dane klienta od danych testowych,
nie dawaj agentowi nieograniczonych uprawnień,
zatwierdzaj komendy przed wykonaniem,
trzymaj raporty w osobnym folderze,
archiwizuj wyniki miesięczne,
anonimizuj dane przed udostępnieniem zewnętrznie.

Anthropic wskazuje, że Claude Code loguje metryki operacyjne, takie jak opóźnienia, niezawodność i wzorce użycia, bez kodu i ścieżek plików, a transmisja i przechowywanie danych telemetrycznych są szyfrowane; można też wyłączyć telemetrię zmienną DISABLE_TELEMETRY.

13. Jak to połączyć z GEO/AEO i AI Search?

Największa wartość nie polega na tym, że Claude Code zrobi ładny wykres. Największa wartość polega na tym, że można połączyć dane GSC z nowym sposobem myślenia o widoczności:

spada CTR mimo rosnących impresji → możliwy problem snippetów, AI Overviews, SERP features lub intencji,
rośnie pozycja, ale nie rosną kliknięcia → możliwa zmiana zachowania użytkownika,
rosną zapytania porównawcze → potrzeba listicles, rankingów, tabel,
rosną zapytania definicyjne → potrzeba Short Answer i FAQ,
spadają artykuły poradnikowe → potrzeba aktualizacji, danych i własnego doświadczenia,
rosną zapytania brandowe → potrzeba stron „o nas”, case studies, opinii i entity signals.

To jest moment, w którym raportowanie SEO staje się raportowaniem visibility intelligence.

14. Minimalny plan wdrożenia w 7 dni

Dzień 1: przygotowanie folderu

utworzyć folder projektu,
zebrać eksporty GSC,
stworzyć listę brand terms,
stworzyć CLAUDE.md.

Dzień 2: pierwszy raport CSV

analiza 28 vs 28 dni,
top wzrosty,
top spadki,
CTR opportunities.

Dzień 3: segmentacja

brand / non-brand,
device,
country,
content type,
URL category.

Dzień 4: wykresy

time series,
bar charts,
heatmapy,
scorecardy.

Dzień 5: komentarz ekspercki

hipotezy,
rekomendacje,
priorytety 7/30/90 dni.

Dzień 6: automatyzacja

skrypt pobierania danych przez API,
szablon raportu,
zapis do /reports.

Dzień 7: wersja dla klienta / zarządu

krótki executive summary,
wykresy,
tabela działań,
aneks danych.

15. Podsumowanie

Raportowanie SEO wchodzi w nowy etap. Klasyczne dashboardy nadal są potrzebne, ale nie wystarczają, gdy pytania biznesowe zmieniają się szybciej niż szablony raportów. Claude Code pozwala pracować z danymi GSC bardziej elastycznie: generować własne widoki, porównania, wykresy i komentarze wtedy, kiedy są potrzebne.

Najważniejsza zmiana:

SEO raport przestaje być statycznym dashboardem, a staje się rozmową z danymi.

Dla GEOknows to kierunek bardzo spójny z Nowym SEO: raporty powinny pokazywać nie tylko kliknięcia i pozycje, ale też szanse na cytowania AI, spadki CTR, tematy narażone na zero-click, luki FAQ, brakujące Short Answers i potencjał query fan-out.

Meta — Yoast SEO

Fraza kluczowa:
raporty SEO Claude Code Google Search Console

Tytuł SEO:
Jak budować raporty SEO z Claude Code i Google Search Console?

Link / slug:
raporty-seo-claude-code-google-search-console

Opis:
Przewodnik GEOknows: jak tworzyć własne raporty SEO z Claude Code i Google Search Console. GSC API, BigQuery, CTR, non-brand, GEO i AEO.

Źródła

Search Engine Land — poradnik Bruce’a Clay’a o budowaniu raportów SEO z Claude Code i Google Search Console.
Anthropic Claude Code Docs — oficjalny opis Claude Code jako agenticznego narzędzia do pracy z kodem, plikami i komendami.
Google Search Console API — dokumentacja metody searchanalytics.query, wymiary, filtry i ograniczenia danych.
Google Search Console Help — Bulk Data Export do BigQuery.
Google Cloud Blog — analiza danych Search Console w BigQuery i zastosowanie bulk export dla większych serwisów.
Google Looker Studio / Data Studio — konektor Search Console do raportów i łączenia z innymi źródłami.
Google Search Console Help — Search Console Insights jako uproszczony raport trendów i metryk.
Anthropic Claude Code Docs — uprawnienia, reguły allow/ask/deny i data usage.

Napisz do nas jak chciałabyś/chciałbyś aby Twój produkt/usługa był prezentowany w naszym multiversum i by omówić szczegóły współpracy:

📧 kontakt@geoknows.pl

🌍 GEOknows.pl | SalesBot.pl | IntegratorAI.pl