Szybka odpowiedź: jak automatycznie testować SEO przed wdrożeniem?
- Reguły SEO muszą żyć w kodzie i testach, a nie w liście kontrolnej: jeden helper metadanych, jedno źródło linku kanonicznego i hreflang, przekierowania jako mapa danych.
- Testy jednostkowe sprawdzają logikę helperów i danych, a Playwright renderowany HTML, nagłówki i statusy odpowiedzi.
- Przy przekierowaniach sprawdzaj status pierwszej odpowiedzi i nagłówek
Location, bez podążania za przekierowaniem. - Uruchamiaj testy w GitHub Actions jako wymagane sprawdzenie przy każdym pull requeście, żeby błąd był czerwonym testem przed scaleniem.
- Przy tysiącach stron szybkie walidacje obejmują cały zbiór danych, a testy przeglądarkowe przedstawicieli szablonów.
Dlaczego techniczne SEO zasługuje na testy regresji
W aplikacjach testujemy logikę biznesową, komponenty i ścieżki użytkownika, a metadane SEO traktujemy często tak, jakby były odporne na zmiany. Tymczasem to właśnie one są wyjątkowo kruche, ponieważ zależą od konfiguracji, która łatwo wymyka się spod kontroli przy refaktorze. Przykłady z projektów:
- stagingowy
noindextrafił na produkcję, - link kanoniczny wszystkich filtrów wskazuje bieżący URL z parametrami,
- wersja EN nie odsyła hreflangiem do PL,
- migracja zmieniła przekierowanie stałe na tymczasowe,
- nowy layout nie przekazuje
description, - strona kategorii ma pusty
<title>.
Wspólnym mianownikiem tych błędów jest to, że żaden z nich nie wywoła awarii widocznej dla użytkownika. Aplikacja działa bez zarzutu, testy funkcjonalne są zielone, a problem ujawnia się dopiero w Google Search Console albo wtedy, gdy ruch organiczny zaczyna spadać, czyli z perspektywy biznesu o wiele za późno. Test regresji SEO domyka tę lukę, bo sprawdza dokładnie te rzeczy, których nie widać gołym okiem, ale które decydują o tym, jak stronę traktuje wyszukiwarka.
Co testować w automatycznych testach SEO
Dobry zestaw koncentruje się na kilku obszarach, które najczęściej ulegają regresji. Pierwszy to i nagłówek X-Robots-Tag, czyli najważniejsza asercja w całym zestawie, bo strony przeznaczone do indeksowania nie mogą zawierać noindex. Drugi to , który musi istnieć, być bezwzględny i wskazywać właściwą wersję strony. Trzeci to tytuł i meta description, których brak oznacza utratę kontroli nad tym, jak strona prezentuje się w wynikach. Na stronach wielojęzycznych dochodzi , na stronach z danymi strukturalnymi JSON-LD, a na końcu są przekierowania, które muszą prowadzić jednym skokiem do właściwego celu.
Nie wszystko trzeba sprawdzać w przeglądarce. Część reguł najtaniej złapać w testach jednostkowych helperów i danych, zanim w ogóle dojdzie do renderu, a Playwright zostawić dla tego, co widać dopiero w gotowym HTML i nagłówkach odpowiedzi. Kolejne sekcje idą według tego podziału.
Jedno źródło prawdy dla metadanych SEO
Gdy każdy szablon sam składa metadane, łatwo o różne reguły adresowania. Jeden zachowa parametry kampanii, inny wskaże domenę preview. Ustal wspólną domenę kanoniczną, politykę parametrów i format ścieżek.
Pierwszy krok to helper, który centralizuje reguły.
Helper zakłada jeden serwis na jednej domenie. Zachowuje parametry funkcjonalne, usuwa rozpoznane parametry kampanii i fragment URL. Decyzję, czy filtr lub paginacja ma własny canonical, podejmij w danych strony; nie usuwaj wszystkich parametrów automatycznie. Format końcowego ukośnika również powinien wynikać z routingu. index i follow są niezależnymi ustawieniami.
Jak testować link kanoniczny
Google traktuje link kanoniczny jako mocny sygnał, ale nie jako rozkaz. Jeśli wysyłasz sprzeczne sygnały, wyszukiwarka może wybrać inaczej, niż chcesz.
Dla indeksowalnych stron w tym przykładzie wymagamy jednego canonical z bezwzględnym adresem, bez parametrów kampanii, do dostępnej strony w tym samym języku. Do sitemap trafiają wybrane adresy kanoniczne. Duplikat może wskazywać inny URL, dlatego nie wymagaj self-canonical na każdej stronie serwisu.
Test jednostkowy helpera:
Test po renderze w Playwright:
Test jednostkowy chroni logikę. Playwright sprawdza, czy HTML naprawdę dostał to, co miał dostać.
Jak wykryć przypadkowy noindex
Brak noindex w DOM nie wystarcza. Zakaz może przyjść w nagłówku X-Robots-Tag, w tagu googlebot albo w HTML wysłanym przez serwer, zanim JavaScript go zmieni. Sprawdź odpowiedź i DOM po renderowaniu. Poniższy test jest przeznaczony dla publicznej strony, która zgodnie z kontraktem ma dopuszczać indeksowanie.
Test rozpoznaje również none, które oznacza noindex, nofollow. Celowo odrzuca zakaz indeksowania w każdym nagłówku X-Robots-Tag, także przypisanym konkretnemu robotowi. Jeśli serwis ma różne reguły dla różnych robotów, potrzebujesz parsera dyrektyw z uwzględnieniem ich adresata. Dodaj także obsługę unavailable_after, jeżeli korzystasz z dat wycofania z indeksu.
robots.txt kontroluje crawlowanie, a noindex indeksowanie. Zakaz pobierania strony może uniemożliwić odczytanie jej noindex; sam Disallow nie gwarantuje usunięcia URL-a z wyników. Sprawdzaj dopuszczenie krytycznych ścieżek parserem reguł robots.txt dla wybranego robota, uwzględniając grupy i priorytety. Samo wyszukanie tekstu Disallow: / jest zbyt uproszczone.
W aplikacji, która ustawia metadane asynchronicznie po stronie klienta, przed odczytem DOM poczekaj na konkretny sygnał gotowości aplikacji. Test Chromium nie odtwarza całego procesu renderowania i indeksowania Google. Nie używaj usuwania serwerowego noindex przez JavaScript jako sposobu udostępnienia strony wyszukiwarce.
Build lokalny, preview i produkcja mają różne reguły
Oddziel adres, pod który wysyłasz żądania, od oczekiwanej domeny kanonicznej. Lokalny build może działać na localhost i generować canonical wskazujący produkcję. Środowisko preview zwykle powinno blokować indeksowanie; test wymagający tam braku noindex byłby błędny. Ochrona preview hasłem ogranicza dostęp, a noindex nie jest zabezpieczeniem poufnych danych.
Utrzymuj jawne kontrakty dla środowisk. Lokalny build z konfiguracją przeznaczoną na produkcję sprawdza reguły aplikacji. Osobny zestaw preview potwierdza ochronę przed indeksowaniem. Po deployu krótki smoke test produkcji weryfikuje rzeczywiste nagłówki, robots.txt, sitemap i najważniejsze przekierowania, ponieważ CDN lub hosting może zmienić odpowiedź. Ustal właściciela alertu i warunek wycofania wdrożenia dla krytycznej regresji.
Jak testować zgodność sitemapy z linkiem kanonicznym
Sitemap i link kanoniczny opowiadają robotowi tę samą historię różnymi kanałami. Jeśli się rozjadą, wysyłasz sprzeczne sygnały: sitemap sugeruje preferowany URL, a strona pod tym URL-em ma link kanoniczny wskazujący gdzie indziej albo noindex. To klasyczna, cicha regresja po refaktorze routingu.
W QA pilnuję trzech rzeczy: w sitemapie są wyłącznie URL-e, które naprawdę mają się indeksować, każdy z nich zwraca 200, a jego link kanoniczny wskazuje sam siebie. Najtaniej sprawdzić to na danych, z których generujesz sitemap, zanim w ogóle dojdzie do renderu.
Ten test sprawdza tylko listę adresów i źródła przekierowań zapisane jako dokładne ścieżki. Nie sprawdza reguł dynamicznych, statusów HTTP ani metadanych. Uzupełnij go kontrolą wygenerowanego XML i żądaniami bez podążania za redirectami: adres z sitemap powinien zwracać 200, mieć oczekiwany self-canonical i dopuszczać indeksowanie. Przy testowaniu lokalnego buildu zachowaj produkcyjny adres jako oczekiwany canonical, a samą ścieżkę pobierz z lokalnego serwera.
Jak testować hreflang i wzajemność wersji językowych
Każda wersja językowa powinna wskazywać samą siebie i pozostałe tłumaczenia pełnymi adresami. Zasady samego wdrożenia, kody języków, x-default i pułapkę częściowych tłumaczeń opisuję w artykule o hreflang i linku kanonicznym w Next.js i Astro. Tutaj skupiam się na tym, jak sprawdzić wynik testem.
Sam test dwukrotnie wywołujący generator z tymi samymi danymi nie sprawdza wzajemności. Poniżej pobieramy każdą wersję osobno i porównujemy rzeczywiście wyrenderowane tagi z oczekiwanym zestawem.
Ścieżki są przykładowe; zastąp je istniejącymi tłumaczeniami. Jeśli używasz x-default, dodaj go do oczekiwanego zestawu. Test wykrywa brak relacji na konkretnej stronie i duplikaty tagów. Osobno sprawdź canonical, indeksowalność i zgodność treści wersji językowych. Status 200 nie wyklucza strony z komunikatem „nie znaleziono”, czyli soft 404.
Google może ignorować relacje bez linków zwrotnych; nie oznacza to automatycznie kary ani szkody większej niż całkowity brak hreflang. Wspólny rejestr tłumaczeń pomaga zapobiegać błędom, a test wyrenderowanych stron sprawdza, czy każdy szablon rzeczywiście go wykorzystuje.
Jak testować metadane: title, description i Open Graph
Dla indeksowalnych stron przyjmij wymaganie niepustego tytułu i opisu. Powinny opisywać konkretną treść; duplikaty raportuj do przeglądu, uwzględniając typ strony i celowe warianty.
W QA sprawdzam zwykle:
<title>nie jest pusty.meta[name="description"]istnieje.- Description nie jest pusty ani złożony wyłącznie ze spacji.
- Open Graph ma poprawny URL, tytuł i obraz; copy może różnić się od SEO title.
- Strony z
noindexsą jawnie oznaczone w danych, a nie przypadkiem.
Przykład testu:
Test wymaga podstawowych tagów zgodnie z kontraktem tego szablonu. Osobna kontrola HTTP obrazu powinna potwierdzać dostępność i typ MIME; sam prefiks HTTPS tego nie zapewnia. Długość opisu traktuj jako wskazówkę redakcyjną, bez arbitralnego progu blokującego merge.
Jak sprawdzić JSON-LD bez utrwalania błędów w snapshotach
Snapshot może przechować błędny obiekt i nadal przechodzić. Dla szablonu artykułu sprawdź, czy JSON da się sparsować, czy zawiera oczekiwany typ i czy wymagane przez projekt pola odpowiadają widocznej treści.
To test kontraktu konkretnego szablonu, w którym headline ma być równy H1; inny typ strony potrzebuje innych asercji. Nie jest pełnym walidatorem Schema.org ani wymagań Google. Rozszerz go o autora, obrazy i identyfikatory odpowiednie dla używanego typu. Narzędzie Rich Results Test pomaga sprawdzić obsługiwane rozszerzenia Google, ale poprawne dane strukturalne nie gwarantują ich wyświetlenia.
Jak testować przekierowania i ich końcowe cele
Redirecty lubią ginąć przy migracjach. Najgorszy układ to redirecty zapisane w panelu hostingu, częściowo w middleware, częściowo w configu, a częściowo w pamięci osoby, która robiła migrację. Przy testowaniu kluczowy jest jeden szczegół: nie wolno automatycznie podążać za przekierowaniem, bo wtedy zobaczysz dopiero stronę docelową, a nie samo przekierowanie. Dlatego testy poniżej wykonują żądanie z maxRedirects: 0 i sprawdzają status oraz nagłówek Location pierwszej odpowiedzi.
Lepszy układ:
Tę listę podłącz do redirects() w konfiguracji Next.js, np. zwracając redirects.map((entry) => ({ ...entry })). W tym mechanizmie permanent: true daje 308, a false daje 307. Kody 301 i 308 oznaczają przekierowanie stałe; 302 i 307 tymczasowe. Asercja powinna odpowiadać wybranemu mechanizmowi, zamiast zawsze wymagać 301.
Poniższy test zakłada dokładne ścieżki i przekierowania w obrębie tego samego środowiska. Wzorce z parametrami wymagają osobnych konkretnych adresów wejściowych.
Wymaganie 200 po pierwszym przekierowaniu wykrywa dodatkowy skok, pętlę i cel zwracający 404. Uzupełnij je kontrolą charakterystycznej treści celu oraz jego canonical. Porównanie aplikacji z jej własną mapą nie wykryje błędnie zaplanowanej migracji, dlatego zachowaj również zatwierdzony zestaw starych URL-i z oczekiwanymi odpowiednikami.
Ten zestaw wyłapuje typowe regresje naraz: podmianę przekierowania stałego na tymczasowe, zerwane przekierowanie, które zaczyna zwracać 404, i łańcuch pośrednich adresów. Jeśli prowadzisz większą migrację adresów, połącz go z wiedzą z artykułu o migracji treści i redirectach 301 przy przejściu z WordPressa na Next.js.
Lista kontrolna testów SEO w pull requeście
Manualna lista kontrolna ma sens tylko wtedy, gdy prowadzi do decyzji. Reszta powinna działać automatycznie.
Dobry podział:
| Obszar | Gdzie sprawdzać |
|---|---|
| Typy danych SEO | TypeScript, Zod, walidacja CMS |
| Link kanoniczny | test helpera + Playwright |
| Hreflang | test relacji w danych + Playwright dla szablonu |
| Noindex | meta robots, googlebot i nagłówki HTTP |
| Redirecty | testy HTTP bez podążania za redirectem |
| Sitemap | test generowanej listy URL-i vs. link kanoniczny |
| Dane strukturalne | parsowanie JSON-LD, pola i zgodność z treścią |
| Bramka | wymagany job w CI na pull requeście |
W pull requeście człowiek powinien sprawdzić intencję: czy ta strona ma się indeksować, czy redirect prowadzi do najlepszego odpowiednika, czy title nie obiecuje czegoś, czego nie ma w treści. Maszyna pilnuje mechaniki.
Jak wpiąć testy regresji SEO w GitHub Actions
Same testy nie chronią niczego, dopóki nie uruchamiają się automatycznie przy każdej zmianie. Poniższy workflow w na każdym pull requeście uruchamia testy jednostkowe, buduje aplikację i sprawdza lokalnie build produkcyjny. Nie jest to test wdrożonego preview.
Przykład zakłada projekt Next.js z npm, zapisanym lockfile oraz zależnościami developerskimi vitest i @playwright/test. Skrypty w package.json to test:unit: vitest run, test:e2e: playwright test, build: next build i start: next start. Testy jednostkowe umieść w src/seo/*.test.ts, a przykłady Playwright w tests/seo/*.spec.ts.
Każdy pokazany test Playwright zawiera @seo w nazwie, więc filtr faktycznie go wybierze. Nie dodawaj opcji pozwalającej przejść przy braku testów. Konfiguracja webServer uruchamia aplikację dopiero po buildzie i czeka na jej dostępność. Stała domena kanoniczna w helperze pozostaje produkcyjna, mimo że żądania trafiają do localhost. W projekcie korzystającym z Yarn lub pnpm dostosuj komendy i cache do jego lockfile.
Aby blokada faktycznie działała, ustaw ten workflow jako wymagane sprawdzenie statusu w regułach ochrony gałęzi main. Dopiero wtedy zielony test staje się warunkiem wejścia kodu na produkcję, a nie tylko informacją, którą można zignorować. Testy Playwright możesz też zastąpić Cypressem, bo oba narzędzia sprawdzą <head> i przekierowania. Pełniejsze porównanie pod kątem CI i testów komponentów mam w zestawieniu Cypress vs Playwright dla projektów Next.js.
Kiedy blokować merge, a kiedy zgłosić ostrzeżenie
| Wynik kontroli | Reakcja |
|---|---|
| Nieplanowany noindex, błędny canonical lub 404 krytycznej strony | Blokada merge |
| Utrata tłumaczenia, pętla albo błędny cel migracji | Blokada merge |
| Niepoprawny JSON-LD wymagany kontraktem szablonu | Blokada merge |
| Nietypowa długość opisu lub podejrzany duplikat copy | Ostrzeżenie do przeglądu |
| Fluktuacja wyniku pomiaru wydajności | Ocena trendu i ustalonego budżetu |
Reguły blokujące powinny wynikać z ryzyka i intencji strony. Dla celowo wycofanego produktu 404 lub 410 może być poprawnym wynikiem. Dodaj taki wyjątek do danych z uzasadnieniem, zamiast wyłączać test dla całego szablonu. Gdy zmieniasz walidator, sprawdź go również na celowo uszkodzonym przypadku: brak odnośnika zwrotnego lub nagłówek noindex musi spowodować błąd.
Agent z Playwright MCP: eksploracja preview i nowe testy
Testy w bramce sprawdzają tylko to, co ktoś wcześniej przewidział. Nowa podstrona, wersja językowa albo parametr w URL-u mogą przejść przez CI bez żadnego testu. Tę lukę dobrze wypełnia agent AI podłączony do przeglądarki przez MCP, np. przez serwer Playwright MCP. Agent otwiera wdrożony preview tak jak tester: przechodzi po nowych adresach, czyta <head>, nagłówki odpowiedzi i listę żądań, po czym zgłasza, co nie zgadza się z kontraktem szablonu.
Prompt powinien być równie konkretny jak test. Na przykład: „Otwórz wszystkie adresy z sekcji /poradnik/ dodane w tym pull requeście. Dla każdego sprawdź status odpowiedzi, X-Robots-Tag, meta robots, canonical i hreflang. Wypisz tylko odstępstwa od reguł z src/seo/”.
Najcenniejsze jest to, co dzieje się po znalezisku. Playwright MCP zapisuje każdą akcję agenta jako kod Playwright (opcja --codegen, domyślnie TypeScript), więc wykryty problem łatwo zamienić w test z tagiem @seo. Od tej chwili ten sam błąd złapie już deterministyczna bramka, a nie agent.
Budżet sieciowy: test, który łapie nowy prefetch
Część regresji nie zmienia ani jednego tagu w <head>. W case study audytu Inspektomat.pl zmiana układu przesunęła sekcję z linkami do pierwszego widoku, a Next.js zaczął pobierać z wyprzedzeniem sześć podstron: 36 dodatkowych żądań i ok. 225 KiB przy każdym wejściu. Żaden test SEO tego nie wykrył, bo HTML był poprawny. Wyszło to dopiero w powtórnym nagraniu sieci.
Takiej regresji nie trzeba oceniać po wahającym się wyniku Lighthouse. Wystarczy policzyć żądania i bajty przy stałym rozmiarze okna i ustawić próg:
Prefetch działa tylko w buildzie produkcyjnym, więc test ma sens w bramce opisanej wyżej, która uruchamia next start. Nagłówek sec-purpose lub purpose mają żądania danych i plików pobieranych przez <link rel="prefetch">, ale część fragmentów kodu dociąganych przy prefetchu go nie ma. Dlatego limit transferu jest drugą siatką bezpieczeństwa. Progi ustaw z zapasem ok. 10–20% ponad obecny stan i podnoś je świadomie w pull requeście, a nie przy pierwszym nieudanym przebiegu.
Częste błędy: gdzie łatwo przesadzić z testami SEO
Przy tysiącach produktów uruchamiaj szybkie walidacje na całym zbiorze danych, a kosztowniejsze testy przeglądarkowe na przedstawicielach szablonów, wszystkich krytycznych URL-ach i przypadkach brzegowych. Uwzględnij brak tłumaczenia, paginację, filtry, pustą kategorię oraz wycofany produkt. Pełniejszy crawl może działać cyklicznie poza bramką PR.
Nie popadaj też w przesadę, blokując merge tylko dlatego, że description ma 79 znaków zamiast 80. Najlepszy zestaw jest mały, szybki i bezwzględnie wyłapuje najważniejsze i najbardziej kosztowne błędy: deindeksację, zły link kanoniczny, utratę wersji językowych, zerwane redirecty i puste metadane.


