Większość zespołów ma już raport pozycji w Google. To zakładka Skuteczność w Search Console, posortowana po kliknięciach i wklejona zrzutem ekranu do slajdu. Pokazuje pozycje. Nie pokazuje, co się zmieniło, dlaczego się zmieniło ani co ktoś miałby z tym zrobić.
Ten przepływ załatwia to w jednym posiedzeniu. Definiujesz zbiór zapytań, przekazujesz Codexowi pisemny kontrakt raportu i pozwalasz mu produkować raport o tym samym kształcie co tydzień. Pierwsze zbudowanie zajmuje około 90 minut. Każde kolejne uruchomienie poniżej dziesięciu.
Cały przepływ: surowe eksporty na wejściu, jeden raport o stałym kształcie na wyjściu i jedna decyzja człowieka na końcu.
Co będzie na końcu
Dla kogo to jest: dla każdego, kto odpowiada za raportowanie dla strony i ma już dostęp do Search Console. Nie musisz być programistą, ale potrzebujesz miejsca na pliki, które Codex potrafi czytać.
Co będziesz mieć na koniec: zapisany szablon raportu, pisemny plik instrukcji, którego Codex trzyma się przy każdym uruchomieniu, oraz jeden gotowy raport za realny tydzień.
Wymagania wstępne: zweryfikowana usługa w Search Console, lista od 20 do 50 zapytań, na których naprawdę ci zależy, Codex z dostępem do folderu projektu i prawo odczytu repozytorium własnej strony, jeśli chcesz wersję zaawansowaną.
Definicja ukończenia: możesz przekazać raport komuś, kto nie zajmuje się SEO, a ta osoba potrafi powiedzieć, na które trzy zapytania patrzeć i dlaczego.
Czas: około 90 minut na pierwsze zbudowanie, poniżej 10 minut na uruchomienie później.
Dlaczego raport Skuteczności nie jest raportem pozycji
Search Console daje cztery kolumny: kliknięcia, wyświetlenia, CTR i średnią pozycję. To tabela pomiarowa. Raport pozycji musi odpowiadać na inny zestaw pytań, a sygnały z 2026 roku rozszerzyły tę lukę bardziej niż dawniej.
Opublikowane 9 września 2026 roku badanie eksperckie Zyppy zebrało 13 665 punktów danych od 131 praktyków. Sygnały kliknięć i zachowania wypadły na 29,4%, sygnały marki na 27,0%, a zdrowie techniczne SEO na 17,5%. Dwa z trzech sygnałów, które wyprzedzają zdrowie techniczne, są niewidoczne w kolumnie pozycji. Nasze własne omówienie tego, co zmieniają te liczby, jest w praktycznym przewodniku, ale krótka wersja dla raportowania brzmi tak: jeśli twój raport pokazuje tylko pozycje, raportujesz sygnał, który ruszył się najmniej.
Dokładnie tę lukę zamyka Codex. Nie powie ci, dlaczego Google coś zmienił. Zbierze dowody zmiany wystarczająco spójnie, żebyś mógł powiedzieć to sam.
Zanim zaczniesz: cztery decyzje
Podejmij je, zanim coś napiszesz, bo zmiana później oznacza przebudowę raportu.
- Zbiór zapytań. Od 20 do 50 zapytań, pogrupowanych w dwa albo trzy koszyki zgodne ze sposobem myślenia biznesu. „Produkt", „porównanie", „wsparcie" działa lepiej niż „wysoki / średni / niski wolumen".
- Okno porównania. Porównuj ostatnie 28 dni z poprzednimi 28. Krótsze okna są zaszumione, dłuższe ukrywają zmianę, której szukasz.
- Próg. Zdecyduj, co liczy się jako warte raportowania. Zapytanie przesuwające się o więcej niż pięć pozycji albo wyświetlenia ruszające się o więcej niż 30% przy płaskich kliknięciach to sensowne wartości domyślne.
- Miejsce przechowywania. Jeden folder, jedna reguła nazewnictwa.
reports/ranking/YYYY-MM-DD.mdplus podfolderdata/na surowe eksporty. Codex potrzebuje stałego miejsca zapisu.
Krok 1: wyeksportuj surowe dane
Otwórz Search Console, wybierz usługę i przejdź do Skuteczności. Ustaw zakres dat na 56 dni, żeby porównanie 28 do 28 było możliwe z jednego eksportu, a potem użyj przycisku Eksportuj, żeby pobrać CSV z zakładki Zapytania.
Zrób to samo dla Stron, a dla Urządzeń, jeśli planujesz raportować podział mobilny kontra desktop.
Oczekiwany wynik: trzy pliki CSV w data/, z datą eksportu w nazwie.
Kontrola jakości: otwórz CSV z zapytaniami i upewnij się, że pierwszy wiersz danych to nie zapytanie zawierające słowo "anonymous". Search Console ukrywa rzadkie zapytania i te wiersze pojawiłyby się w raporcie jako ruch bez nazwy.
Jeśli się nie uda: jeśli eksport jest ucięty, twój zakres dat jest za szeroki wobec limitu wierszy. Wyeksportuj okna 28-dniowe osobno i pozwól Codexowi je połączyć.
Krok 2: napisz kontrakt raportu
To krok, który decyduje, czy przepływ przetrwa trzeci tydzień. Umieść kontrakt w pliku, który Codex czyta przy każdym uruchomieniu: AGENTS.md w katalogu głównym projektu albo dedykowany plik instrukcji w folderze raportów.
Kontrakt potrzebuje pięciu rzeczy i niczego więcej:
Blok kontraktu | Co napisać | Dlaczego to ważne |
|---|---|---|
Wejścia | Dokładne ścieżki plików i reguła zakresu dat | Powstrzymuje agenta przed wymyśleniem okna |
Progi | Twoje pasma, w liczbach | Zamienia tabelę w decyzję |
Kształt wyjścia | Trzy sekcje, w tej kolejności | Utrzymuje porównywalność 30. tygodnia z 1. |
Zasady pewności | Co napisać, gdy dane nie tłumaczą zmiany | Zapobiega pewnym siebie bzdurom |
Granice | Czego agentowi nie wolno | Tylko odczyt, dopóki mu nie zaufasz |
Działająca wersja wygląda tak:
## Kontrakt raportu pozycji
Wejścia: data/queries-*.csv, data/pages-*.csv
Okno: ostatnie 28 dni wobec poprzednich 28. Podaj obie daty w nagłówku raportu.
Raportuj tylko trzy rzeczy:
1. Zapytania, które się ruszyły: każde przesunięte o więcej niż 5 pozycji, albo
wyświetlenia rosnące o więcej niż 30% przy płaskich kliknięciach, albo każde,
które wypadło z pierwszej dziesiątki.
2. Prawdopodobne wyjaśnienie: używaj tylko danych z plików. Jeśli pliki nie
tłumaczą ruchu, napisz "niewyjaśnione przez te dane".
3. Do sprawdzenia w przyszłym tygodniu: jedna linia na oznaczone zapytanie,
z dokładną nazwą strony albo zapytania do sprawdzenia.
Nigdy nie podawaj przyczyny, której nie da się wskazać w danych. Nigdy nie
proponuj zmian na stronie. Nigdy nie edytuj plików poza reports/ranking/.Oczekiwany wynik: jeden plik instrukcji, zacommitowany albo zapisany obok danych.
Kontrola jakości: przeczytaj kontrakt na głos. Jeśli dowolna linia mogłaby bez zmian pasować do innej strony, jest zbyt mglista, żeby cokolwiek ograniczać.
Jeśli się nie uda: jeśli Codex wciąż dodaje sekcje, kształt wyjścia nie jest dość konkretny. Nazwij trzy nagłówki dokładnie tak, jak chcesz je mieć.
Anatomia raportu. Stopka wymieniająca dokładnie użyte pliki to część, której recenzenci ufają najbardziej, i ta, którą większość szablonów pomija.
Krok 3: wygeneruj pierwszy raport
Skieruj Codexa na folder i poproś o jeden raport zgodny z kontraktem. Poproś o plik, nie o odpowiedź w czacie, żeby wynik dało się przejrzeć i porównać.
Przy pierwszym uruchomieniu odkryjesz, jak naprawdę wyglądają twoje dane. Załóż dwie albo trzy rundy poprawek. To normalne i to najtańsza część całego przepływu.
Oczekiwany wynik: reports/ranking/YYYY-MM-DD.md z nagłówkiem, trzema sekcjami i stopką wymieniającą dokładnie użyte pliki.
Kontrola jakości: weź dwa oznaczone zapytania i sprawdź liczby ręcznie w Search Console. Jeśli się zgadzają, pipeline jest zdrowy. Jeśli nie, zatrzymaj się i napraw krok z danymi. Nie debuguj analizy na zepsutym wejściu.
Jeśli się nie uda: najczęstsza porażka to niezgodność dat między eksportem a kontraktem. Przypnij obie daty w nagłówku przy każdym uruchomieniu, żeby przesunięcie o dwa dni nie zamieniło po cichu płaskiego miesiąca w zapaść.
Pierwsza wersja, którą zbudowałem, zaraportowała jedenaście ruszających się zapytań w tygodniu, w którym prawie nic się nie ruszyło. Kontrakt był w porządku, eksport nie. Plik 30-dniowy porównany z oknem 28 dni sprawił, że dwa brakujące dni wyglądały jak zapaść całej strony. Teraz kontrakt odmawia uruchomienia, jeśli oba zakresy się nie zgadzają, i ta porażka już nie wróciła.
Krok 4: dodaj linię, której agent nie potrafi napisać
Każdy raport dostaje jeden ludzki akapit: co wypuściliśmy, zmieniliśmy albo zepsuliśmy w zeszłym tygodniu.
To nie dekoracja. To najszybszy sposób złapania agenta, który przypisuje twoje własne wydanie aktualizacji algorytmu. Kiedy raport mówi, że grupa stron produktowych spadła, a twoja notatka mówi, że szablon zmienił się we wtorek, zakres wyjaśnień zwęża się natychmiast.
Oczekiwany wynik: dwa albo trzy zdania na początku raportu, napisane przez człowieka.
Kontrola jakości: jeśli notatka i sekcja ruchu przeczą sobie, ta sprzeczność jest najcenniejszą linią w raporcie. Zostaw ją widoczną zamiast wygładzać.
Krok 5: zweryfikuj przed wysłaniem
Wykonaj te trzy sprawdzenia, zanim raport opuści twoje biurko.
- Daty. Oba okna podane w nagłówku, zgodne z eksportem.
- Dwa sprawdzenia punktowe. Dwa oznaczone zapytania zweryfikowane ręcznie.
- Jedno sprawdzenie sprzeczności. Czy jakieś twierdzone wyjaśnienie odwołuje się do danych, których nie ma na liście plików na dole?
Jeśli wszystkie trzy przejdą, raport można bezpiecznie udostępniać. To szkic twojego osądu, nie jego zastępstwo.
Ścieżka zaawansowana, gdy będziesz gotowy
Prowadź przepływ ręcznie przez cztery tygodnie. Automatyzuj dopiero po dwukrotnym naprawieniu tej samej klasy błędu.
Potem usprawnienia są stopniowe:
- Zaplanuj uruchomienie. Cotygodniowe uruchomienie z harmonogramu napisze raport, zanim otworzysz laptopa. Zostaw ludzki akapit jako pole obowiązkowe, żeby raport nie mógł wyjść bez niego.
- Przechowuj migawki w kontroli wersji. Każde uruchomienie staje się commitem. Diff między dwoma tygodniami czyta się szybciej niż którykolwiek z raportów.
- Dodaj drugą usługę. Zapytania konkurencji albo marki siedzą w osobnym raporcie z tym samym kontraktem, nie wmieszane w główny.
- Dodaj jeden sygnał zewnętrzny. Sprawdzenie wyszukiwania markowego albo udziału w odpowiedziach czyni sygnał marki z badania 2026 mierzalnym zamiast teoretycznym.
Czego nie automatyzować: kroku z rekomendacją. W momencie, gdy agent zaczyna proponować zmiany na stronie, przeszedłeś z raportowania do publikowania, a obciążenie przeglądem rośnie szybciej niż zaoszczędzony czas.
Rozwiązywanie problemów
Objaw | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
Każde zapytanie wygląda na spadłe | Przesunięcie zakresów dat między eksportami | Przypnij oba okna w kontrakcie i nagłówku |
Raport jest pusty | Progi zbyt surowe dla twojego poziomu ruchu | Obniż próg wyświetleń, zanim obniżysz próg pozycji |
Te same pięć zapytań co tydzień | Zbiór zapytań jest za wąski | Dodaj do koszyków zapytania long tail i porównawcze |
Ruch bez wyjaśnienia | Normalne dla zapytań o niskim wolumenie | Zostaw wynik "niewyjaśnione przez te dane" i idź dalej |
Liczby różnią się od Search Console | Niezgodność usługi albo filtra w eksporcie | Eksportuj zawsze z tej samej usługi i tego samego zestawu filtrów |
Utrzymuj przepływ
Trzy nawyki utrzymaniowe zachowują jego użyteczność po pierwszym kwartale.
Przeglądaj zbiór zapytań co kwartał. Raport goniący za zeszłorocznymi priorytetami to lekcja historii, nie raport pozycji.
Czytaj kontrakt od nowa, gdy zmienia się Search Console. Google okresowo aktualizuje interfejs raportu Skuteczności i pola eksportu. Jeśli pole zniknie, kontrakt wymaga poprawki tego samego dnia.
Zachowuj stare raporty. Porównanie raportu z tego kwartału z tym samym kwartałem zeszłego roku to jedyny tani sposób oddzielenia prawdziwego spadku od sezonowości.
Częste pytania (FAQ)
Czy potrzebuję konkretnie Codexa? Nie. Przepływ działa z każdym agentem, który czyta pliki, uruchamia się z harmonogramu i pisze wynik dający się przejrzeć. Codex pasuje, gdy twoja strona już żyje w repozytorium, bo raport staje się commitem, który możesz porównać.
Da się to zrobić tylko darmowymi narzędziami? Da się. Cały przepływ działa na darmowych danych z Search Console plus agent. Płatny tracker pozycji potrzebny jest dopiero wtedy, gdy chcesz pozycje konkurencji albo pozycje, których nie widzisz we własnej usłudze.
Czym to się różni od raportu Skuteczności w Search Console? Raport Skuteczności pokazuje tabelę. Ten przepływ produkuje decyzję: które zapytania przekroczyły próg, co dane wyjaśniają, a czego nie, i co sprawdzić w przyszłym tygodniu. Prowadzi też rejestr, czego interfejs nie robi.
A jeśli moja strona ma bardzo mało ruchu? Obniż próg wyświetleń i porównuj 28 dni z tymi samymi 28 dniami zeszłego roku zamiast z poprzednimi 28. Strony o niskim wolumenie czerpią więcej sygnału z porównań rok do roku niż z tygodnia do tygodnia.
Czy raport powinien zawierać AI Overviews albo cytowania AI? Jeśli chcesz, dodaj osobną sekcję z własnym kontraktem. Trzymaj ją poza raportem pozycji, bo źródła i pomiar są inne, a mieszanie utrudnia czytanie obu.
Autor: Leo Harrington, tłumacz analityki SEO dla ponad 500 raportów zarządczych w Auspia. Leo pisze o zamienianiu danych wyszukiwania w raporty, na których może działać niespecjalista.
