Przejdź do treści

Testy regresji SEO w CI: noindex, canonical, hreflang i przekierowania

Maciej Sala

Founder StriveLab

14 min czytaniaAktualizacja

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 noindex trafił 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.

Code
// src/seo/metadata.ts
import type { Metadata } from 'next'
 
type Locale = 'pl' | 'en'
 
type SeoInput = {
  path: string
  title: string
  description: string
  index?: boolean
  follow?: boolean
  alternates?: Partial<Record<Locale, string>>
}
 
const siteUrl = 'https://example.com'
 
export function canonicalUrl(path: string) {
  const url = new URL(path, siteUrl)
  if (url.origin !== siteUrl) throw new Error('Unexpected canonical origin')
  url.hash = ''
  for (const key of [...url.searchParams.keys()]) {
    if (/^utm_/i.test(key) || ['gclid', 'fbclid'].includes(key.toLowerCase())) {
      url.searchParams.delete(key)
    }
  }
  return url.toString()
}
 
export function buildSeoMetadata(input: SeoInput) {
  const canonical = canonicalUrl(input.path)
  const shouldIndex = input.index !== false
 
  return {
    title: input.title,
    description: input.description,
    robots: { index: shouldIndex, follow: input.follow !== false },
    alternates: {
      canonical,
      languages: buildLanguageAlternates(input.alternates),
    },
  } satisfies Metadata
}
 
function buildLanguageAlternates(alternates?: SeoInput['alternates']) {
  if (!alternates) return undefined
 
  return Object.fromEntries(
    Object.entries(alternates).map(([locale, path]) => [
      locale,
      canonicalUrl(path),
    ]),
  )
}

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.

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:

Code
import { describe, expect, it } from 'vitest'
import { buildSeoMetadata } from './metadata'
 
describe('buildSeoMetadata', () => {
  it('builds an absolute canonical URL', () => {
    const metadata = buildSeoMetadata({
      path: '/blog/test/?utm_source=newsletter#sekcja',
      title: 'Test',
      description: 'Opis testowy',
    })
 
    expect(metadata.alternates.canonical).toBe('https://example.com/blog/test/')
  })
})

Test po renderze w Playwright:

Code
import { expect, test } from '@playwright/test'
 
test('@seo blog post has one absolute canonical URL', async ({ page }) => {
  await page.goto('/blog/przykladowy-wpis/')
 
  const canonicals = page.locator('link[rel="canonical"]')
  await expect(canonicals).toHaveCount(1)
 
  await expect(canonicals).toHaveAttribute(
    'href',
    'https://example.com/blog/przykladowy-wpis/',
  )
})

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.

Code
// tests/seo/indexability.spec.ts
import { expect, test } from '@playwright/test'
 
const blocksIndexing = /(?:^|[\s,:;])(noindex|none)(?=$|[\s,;])/i
const robotsSelector = 'meta[name="robots" i], meta[name="googlebot" i]'
 
test('@seo public page permits indexing', async ({ page, request }) => {
  const path = '/uslugi/next-js/'
  const response = await request.get(path, { maxRedirects: 0 })
  expect(response.status()).toBe(200)
  expect(response.headers()['content-type']).toContain('text/html')
 
  const headers = response
    .headersArray()
    .filter(({ name }) => name.toLowerCase() === 'x-robots-tag')
  for (const { value } of headers) {
    expect(value).not.toMatch(blocksIndexing)
  }
 
  // Parsowanie HTML z odpowiedzi bez wykonywania skryptów.
  const rawDirectives = await page.evaluate(
    ({ html, selector }) => {
      const document = new DOMParser().parseFromString(html, 'text/html')
      return [...document.querySelectorAll(selector)].map(
        (node) => node.getAttribute('content') ?? '',
      )
    },
    { html: await response.text(), selector: robotsSelector },
  )
  for (const value of rawDirectives) expect(value).not.toMatch(blocksIndexing)
 
  const navigation = await page.goto(path)
  expect(navigation?.status()).toBe(200)
  expect((await navigation?.headerValue('x-robots-tag')) ?? '').not.toMatch(
    blocksIndexing,
  )
  const renderedDirectives = await page
    .locator(robotsSelector)
    .evaluateAll((nodes) =>
      nodes.map((node) => node.getAttribute('content') ?? ''),
    )
  for (const value of renderedDirectives)
    expect(value).not.toMatch(blocksIndexing)
})

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.

Code
import { describe, expect, it } from 'vitest'
import { buildSitemapUrls } from './sitemap'
import { redirects } from './redirects'
 
describe('buildSitemapUrls', () => {
  const urls = buildSitemapUrls()
 
  it('contains only absolute, deduplicated URLs', () => {
    const unique = new Set(urls)
    expect(unique.size).toBe(urls.length)
    for (const url of urls) {
      expect(url.startsWith('https://example.com/')).toBe(true)
    }
  })
 
  it('never lists a URL that is a redirect source', () => {
    const sources = new Set(
      redirects.map((r) => `https://example.com${r.source}`),
    )
    for (const url of urls) {
      expect(sources.has(url)).toBe(false)
    }
  })
})

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.

Code
// tests/seo/hreflang.spec.ts
import { expect, test } from '@playwright/test'
 
const translations = {
  pl: '/uslugi/next-js/',
  en: '/en/services/next-js/',
}
const expected = Object.entries(translations)
  .map(([lang, path]) => ({
    lang,
    href: new URL(path, 'https://example.com').href,
  }))
  .sort((a, b) => a.lang.localeCompare(b.lang))
 
for (const [locale, path] of Object.entries(translations)) {
  test(`@seo ${locale} exposes reciprocal hreflang`, async ({
    page,
    request,
  }) => {
    // Żądanie bez redirectów wykryje również tłumaczenie przekierowane na stronę główną.
    const response = await request.get(path, { maxRedirects: 0 })
    expect(response.status()).toBe(200)
    await page.goto(path)
 
    const links = page.locator('link[rel="alternate"][hreflang]')
    await expect
      .poll(async () =>
        links.evaluateAll((nodes) =>
          nodes
            .map((node) => ({
              lang: node.getAttribute('hreflang'),
              href: node.getAttribute('href'),
            }))
            .sort((a, b) => (a.lang ?? '').localeCompare(b.lang ?? '')),
        ),
      )
      .toEqual(expected)
  })
}

Ś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 noindex są jawnie oznaczone w danych, a nie przypadkiem.

Przykład testu:

Code
import { expect, test } from '@playwright/test'
 
test('@seo service page exposes basic metadata', async ({ page }) => {
  await page.goto('/uslugi/next-js/')
  await expect(page).toHaveTitle(/Next\.js/)
  const description = page.locator('meta[name="description"]')
  await expect(description).toHaveCount(1)
  await expect(description).toHaveAttribute('content', /\S/)
  await expect(page.locator('meta[property="og:title"]')).toHaveAttribute(
    'content',
    /\S/,
  )
  await expect(page.locator('meta[property="og:url"]')).toHaveAttribute(
    'content',
    'https://example.com/uslugi/next-js/',
  )
  await expect(
    page.locator('meta[property="og:image"]').first(),
  ).toHaveAttribute('content', /^https:\/\//)
})

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.

Code
// tests/seo/structured-data.spec.ts
import { expect, test } from '@playwright/test'
 
test('@seo article exposes matching JSON-LD', async ({ page }) => {
  await page.goto('/blog/przykladowy-wpis/')
  const scripts = page.locator('script[type="application/ld+json"]')
  await expect(scripts.first()).toBeAttached()
  const documents = (await scripts.allTextContents()).map((text) =>
    JSON.parse(text),
  )
  // Obsługujemy obiekt, tablicę oraz węzły w @graph.
  const nodes = documents
    .flatMap((doc) => (Array.isArray(doc) ? doc : [doc]))
    .flatMap((node) =>
      node && typeof node === 'object' && Array.isArray(node['@graph'])
        ? [node, ...node['@graph']]
        : [node],
    )
  const articles = nodes.filter((node) => {
    const types = node?.['@type']
    return (Array.isArray(types) ? types : [types]).includes('BlogPosting')
  })
  expect(articles).toHaveLength(1)
  const heading = (await page.locator('h1').innerText()).trim()
  expect(heading).not.toBe('')
  expect(articles[0].headline).toBe(heading)
  expect(articles[0].datePublished).toMatch(/^\d{4}-\d{2}-\d{2}T/)
  expect(Number.isNaN(Date.parse(articles[0].datePublished))).toBe(false)
})

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:

Code
// src/seo/redirects.ts
export const redirects = [
  {
    source: '/stary-blog/jak-wybrac-framework/',
    destination: '/blog/astro-js-vs-next-js-porownanie-frameworkow/',
    permanent: true,
  },
  {
    source: '/kontakt.html',
    destination: '/kontakt/',
    permanent: true,
  },
] as const

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.

Code
import { expect, test } from '@playwright/test'
import { redirects } from '../../src/seo/redirects'
 
for (const redirect of redirects) {
  test(`@seo ${redirect.source} redirects to ${redirect.destination}`, async ({
    request,
  }) => {
    const response = await request.get(redirect.source, { maxRedirects: 0 })
 
    expect(response.status()).toBe(redirect.permanent ? 308 : 307)
    const location = response.headers().location
    expect(location).toBeTruthy()
    const target = new URL(location!, response.url())
    expect(target.href).toBe(new URL(redirect.destination, response.url()).href)
 
    const destination = await request.get(target.href, { maxRedirects: 0 })
    expect(destination.status()).toBe(200)
  })
}

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ł:

ObszarGdzie sprawdzać
Typy danych SEOTypeScript, Zod, walidacja CMS
Link kanonicznytest helpera + Playwright
Hreflangtest relacji w danych + Playwright dla szablonu
Noindexmeta robots, googlebot i nagłówki HTTP
Redirectytesty HTTP bez podążania za redirectem
Sitemaptest generowanej listy URL-i vs. link kanoniczny
Dane strukturalneparsowanie JSON-LD, pola i zgodność z treścią
Bramkawymagany 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.

Code
// playwright.config.ts
import { defineConfig } from '@playwright/test'
 
export default defineConfig({
  testDir: './tests/seo',
  use: { baseURL: 'http://127.0.0.1:3000', browserName: 'chromium' },
  webServer: {
    command: 'npm run start -- --hostname 127.0.0.1 --port 3000',
    url: 'http://127.0.0.1:3000',
    reuseExistingServer: false,
    timeout: 120_000,
  },
})
Code
# .github/workflows/seo-qa.yml
name: SEO QA
on: pull_request
permissions:
  contents: read
 
jobs:
  seo-qa:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 24
          cache: npm
      - run: npm ci
      - run: npm run test:unit -- src/seo
      - run: npx playwright install --with-deps chromium
      - run: npm run build
      - run: npm run test:e2e -- --grep @seo

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 kontroliReakcja
Nieplanowany noindex, błędny canonical lub 404 krytycznej stronyBlokada merge
Utrata tłumaczenia, pętla albo błędny cel migracjiBlokada merge
Niepoprawny JSON-LD wymagany kontraktem szablonuBlokada merge
Nietypowa długość opisu lub podejrzany duplikat copyOstrzeżenie do przeglądu
Fluktuacja wyniku pomiaru wydajnościOcena 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:

Code
// tests/seo/network-budget.spec.ts
import { expect, test, type Request } from '@playwright/test'
 
// Prefetch i leniwe obrazy zależą od tego, co mieści się w oknie,
// dlatego budżet ma sens tylko przy stałym viewporcie.
test.use({ viewport: { width: 1440, height: 900 } })
 
const MAX_PREFETCH_REQUESTS = 2
const MAX_TRANSFER_KIB = 600
 
test('@seo homepage stays within network budget', async ({ page }) => {
  const finished: Request[] = []
  page.on('requestfinished', (request) => finished.push(request))
 
  await page.goto('/')
  // Next.js pobiera strony dla widocznych linków, gdy przeglądarka jest bezczynna.
  await page.waitForTimeout(7_000)
 
  const prefetched: string[] = []
  let transferBytes = 0
  for (const request of finished) {
    const headers = await request.allHeaders()
    const purpose = `${headers['sec-purpose'] ?? ''} ${headers['purpose'] ?? ''}`
    if (purpose.includes('prefetch') || headers['next-router-prefetch']) {
      prefetched.push(request.url())
    }
    const sizes = await request.sizes()
    transferBytes += sizes.responseHeadersSize + sizes.responseBodySize
  }
 
  expect(prefetched.length, prefetched.join('\n')).toBeLessThanOrEqual(
    MAX_PREFETCH_REQUESTS,
  )
  expect(transferBytes / 1024).toBeLessThanOrEqual(MAX_TRANSFER_KIB)
})

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.

Testy automatyczne komponentów i E2E w Cypress.
QA & Automation

Często zadawane pytania

Dlaczego warto testować SEO automatycznie, skoro mam Search Console?

Bo Search Console informuje o problemie po fakcie, często z kilkudniowym opóźnieniem, gdy regresja jest już na produkcji. Przypadkowy noindex albo zepsuty link kanoniczny potrafi wyciąć stronę z indeksu na tygodnie, zanim zauważysz spadek ruchu. Test w CI wyłapuje taki błąd, zanim kod zostanie zmergowany, więc przesuwa wykrycie z „ruch spadł" na „pull request nie przeszedł".

Czym testy SEO różnią się od audytu SEO?

Audyt mówi, co jest aktualnie zepsute, a testy mają sprawić, że ten sam błąd nie wróci przy najbliższym wdrożeniu. To różnica między raportem a systemem ochrony w kodzie.

Co powinien sprawdzać test regresji SEO?

Minimum to brak przypadkowego noindex na stronach, które mają się indeksować, jeden bezwzględny link kanoniczny, niepusty tytuł i meta description, wzajemny hreflang na stronach wielojęzycznych, oczekiwane statusy i cele przekierowań oraz poprawne JSON-LD tam, gdzie szablon go wymaga.

Czy wszystko trzeba testować w Playwright?

Nie. Część rzeczy lepiej sprawdzić statycznie w TypeScript albo w walidacji danych. Playwright zostaw dla renderowanego HTML, nagłówków i przekierowań. Im bliżej źródła błędu złapiesz problem, tym mniej kosztuje naprawa.

Playwright czy Cypress do testów SEO?

Oba narzędzia poradzą sobie z tym zadaniem, bo testy SEO sprowadzają się do sprawdzenia zawartości <head> i zachowania przy przekierowaniach. Dla zestawów regresyjnych w CI częściej rekomenduje się Playwright ze względu na stabilność testów i wygodną integrację z GitHub Actions. Cypress świetnie sprawdza się przy testowaniu komponentów w trakcie developmentu.

Jak testować przekierowania w Playwright?

Wykonaj żądanie bez podążania za przekierowaniem, czyli request.get(url, { maxRedirects: 0 }), i sprawdź status oraz nagłówek Location pierwszej odpowiedzi. Oczekiwany status zależy od mechanizmu: konfiguracja serwera zwykle zwraca 301, a redirects() w Next.js z permanent: true zwraca 308. Potem pobierz cel i upewnij się, że zwraca 200.

Czy takie testy spowalniają pipeline CI/CD?

Minimalnie. Testy SEO sprawdzają zawartość HTML i nagłówki odpowiedzi, więc nie wymagają klikania przez całą aplikację. Zestaw kilkunastu asercji na kluczowych typach stron wykonuje się w kilkanaście sekund, a najdłużej trwa sam build.

Czy testy SEO mają sens na małej stronie firmowej?

Tak, ale zakres powinien być mały. Dla strony firmowej wystarczy kilka testów na głównych szablonach i przekierowaniach. Rozbudowany system ma sens przy blogu, e-commerce, wielu językach albo częstych wdrożeniach.

Kto powinien utrzymywać testy SEO: SEO czy deweloperzy?

Zakres powinien powstać wspólnie. Deweloperzy utrzymują testy i helpery w kodzie, a SEO wskazuje reguły biznesowe: które strony mają się indeksować, jakie przekierowania muszą działać i które segmenty URL dowożą ruch.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat SEO

Czytaj dalej

Zobacz więcej wpisów
Hreflang i link kanoniczny w Next.js i Astro: wdrożenie bez duplikacji

Hreflang i link kanoniczny rozwiązują dwa różne problemy wielojęzycznego SEO: właściwy język wyniku i właściwy adres do indeksowania. Zasady są te same w każdym frameworku, a różni się tylko miejsce, w którym generujesz znaczniki. W Next.js App Router robi to Metadata API , a w Astro layout korzystający z wbudowanego routingu i18n.

Maciej Sala

Maciej Sala

Founder StriveLab

Zaawansowane testy E2E z Playwright w Next.js

Playwright idealnie sprawdza się w projektach opartych na Next.js App Router, ponieważ testuje aplikację dokładnie tak, jak widzi ją użytkownik: od uwzględnienia streamingu HTML, przez płynną nawigację, aż po formularze i interakcje. Wbudowane funkcje, takie jak automatyczne oczekiwanie, fixtures, zaawansowane zarządzanie żądaniami oraz testy wizualne, pozwalają kompleksowo zabezpieczyć jakość kodu bez konieczności dokładania kolejnych, zewnętrznych narzędzi.

Maciej Sala

Maciej Sala

Founder StriveLab

Audyt techniczny SEO: co obejmuje w 2026 roku?

To, że strona otwiera się w przeglądarce, nie oznacza jeszcze, że robot wyszukiwarki jest w stanie bez przeszkód pobrać jej treść, poprawnie ją zinterpretować i ostatecznie włączyć do indeksu. Audyt techniczny SEO służy właśnie do weryfikacji tych krytycznych warunków. Pozwala on zidentyfikować fundamenty wymagające naprawy i wyznaczyć właściwe priorytety, zanim przejdziemy do rozbudowy treści oraz pozyskiwania linków.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G