Przejdź do treści

Duplikacja treści przez parametry w URL w Next.js i Astro

Maciej Sala

Founder StriveLab

20 min czytaniaAktualizacja

Szybka odpowiedź: jak obsłużyć parametry w URL, żeby nie duplikować treści?

  • Duplikacja treści przez parametry w URL powstaje, gdy ten sam stan strony ma wiele adresów. Zacznij od podziału parametrów na aktywne, które zmieniają treść, i pasywne, które tylko śledzą.
  • Link kanoniczny konsoliduje sygnały, noindex wyklucza z indeksu, robots.txt ogranicza crawlowanie, a przekierowanie normalizuje adres.
  • Te mechanizmy nie są zamiennikami.
  • Aplikacja nie powinna tworzyć wielu adresów dla jednego stanu, więc normalizuj kolejność i wartości parametrów.
  • Bezwartościowe kombinacje filtrów wymagają ograniczenia odkrywania lub blokady crawlowania.

Jeśli chcesz, żeby ktoś po prostu znalazł te problemy w Twoim kodzie i je naprawił, to zakres mojej usługi Audyt techniczny SEO.

Czym jest parametr w URL i z czego się składa

Parametr URL (inaczej ) to dodatkowe dane doklejone na końcu adresu, które mówią serwerowi lub aplikacji, co ma zrobić. Najczęściej dotyczy to zmiany wyświetlanej treści albo zmierzenia czegoś.

Code
https://example.com/products?category=shoes&sort=price-asc
└───────────┬──────────────┘ └───────────┬───────────────┘
        bazowy URL                    parametry zapytania

Składowe powyższego adresu:

  • bazowy URL to https://example.com/products, czyli adres bez query stringa; nie staje się przez to automatycznie adresem kanonicznym.
  • znak zapytania ? jest separatorem, który oznacza koniec ścieżki i początek parametrów zapytania; w tej roli może wystąpić tylko raz.
  • pary klucz-wartość mają postać category=shoes, gdzie category to klucz, a shoes wartość. Łączy je znak =.
  • ampersand & łączy kolejne pary. Twardego limitu nie ma, ale im jest krócej tym lepiej.

Osobny przypadek to fragment (#), np. #sekcja. Fragment nie jest wysyłany w żądaniu HTTP, a przeglądarka używa do przewinięcia do kotwicy. Część frameworków JavaScript używała kiedyś # do nawigacji (hash-based routing), co nie nadaje się do rozróżniania stron przeznaczonych do indeksowania. Fragment może natomiast przechowywać stan filtrów, których nie chcesz udostępniać jako osobnych stron wyszukiwarki. Zapamiętaj różnicę: ? wysyła dane do serwera, # działa po stronie klienta.

Parametry aktywne vs pasywne

Dawne narzędzie URL Parameters w Search Console zostało wycofane, dlatego dziś zasady trzeba wymusić we własnej architekturze, linkowaniu i odpowiedziach HTTP.

  • Aktywne (zmieniające treść) modyfikują to, co widzi użytkownik, na przykład sortowanie (?sort=price-asc), filtrowanie (?color=blue), paginacja (?page=2), wyszukiwarka wewnętrzna (?q=...) i język (?lang=fr).
  • Pasywne (śledzące) nie zmieniają treści, tylko zbierają dane, na przykład UTM-y (?utm_source=newsletter), ID afiliacyjne (?affid=...), o ile nie zmieniają oferty. ID sesji (?sessionid=...) mogą wpływać na personalizację, więc wymagają sprawdzenia zachowania aplikacji.

Reguła kciuka:

  • pasywne zwykle tworzą duplikaty, więc najczęściej powinny prowadzić do czystego linku kanonicznego i nie pojawiać się w linkowaniu wewnętrznym,
  • aktywne wymagają decyzji: ?sort= może tworzyć bardzo podobny widok, ale przy paginacji zmienia też zestaw elementów na danej stronie; ale ?lang=fr to osobna, indeksowalna wersja strony, a ?category=running-shoes może być wartościowym , który chcesz indeksować. Potraktowanie tych ostatnich jak zwykłych duplikatów to poważny błąd.

Typy parametrów i ich obsługa

TypCelPrzykładTypowe podejście SEO
FiltrowanieZawęża treść?color=blueIndeksacja wartościowego landingu; inaczej noindex lub kontrola crawla, canonical dla podobnych treści
SortowanieZmienia kolejność?sort=price-ascCanonical dla podobnych treści; inaczej noindex lub kontrola crawla
PaginacjaDzieli treść?page=2Samoreferencyjny link kanoniczny (patrz niżej)
Wyszukiwanie wewn.Wyniki wyszukiwarki?q=reactnoindex albo blokada crawlowania zależnie od celu
Język/lokalizacjaWersja językowa?lang=frIndeksacja + hreflang; zwykle lepszy jest osobny URL
UTMŚledzenie kampanii?utm_source=fbLink kanoniczny do bazy
ID sesjiSesja użytkownika?sessionid=xyzLink kanoniczny; lepiej użyć cookies
ID afiliacyjneMarketing afiliacyjny?affid=blogLink kanoniczny do bazy

Szczególnie groźna jest w e-commerce, czyli kilkanaście filtrów po kilka wartości każdy potrafi wygenerować miliony kombinacji URL-i. To główne źródło problemów z w dużych sklepach internetowych. Trzeba tego pilnować.

Parametr językowy wymaga osobnej ostrożności. Każda wersja językowa powinna mieć własny link kanoniczny w tym samym języku oraz wzajemne adnotacje hreflang; link kanoniczny wszystkich wersji do języka głównego wysyła sprzeczny sygnał o preferowanej wersji, choć Google może go zignorować. Parametry są technicznie możliwe, ale ścieżki takie jak /pl/ i /en/ zwykle upraszczają linkowanie, sitemap oraz debugowanie. Poprawną relację między linkiem kanonicznym i hreflang rozkładam na czynniki w osobnym przewodniku po hreflang i linku kanonicznym w Next.js i Astro.

Jak parametry URL szkodzą SEO przez duplikację treści i budżet indeksowania

Różne URL-e mogą być osobno odkrywane i pobierane, ale Google może rozpoznać duplikaty i wybrać jedną wersję kanoniczną. Niekontrolowana liczba adresów tworzy kilka ryzyk.

Duplikacja treści. /produkty i /produkty?utm_source=mail zwykle pokazują tę samą treść. Natomiast ?color=red może zawężać ofertę, a ?sessionid=xyz wpływać na personalizację. Nie każdy wariant jest duplikatem i nie każdy trafi osobno do indeksu. Niespójne sygnały mogą utrudnić wybór preferowanego adresu, ale sama obecność parametrów nie oznacza automatycznie kanibalizacji.

Marnowanie budżetu indeksowania. ma ograniczony budżet na crawlowanie strony, dlatego jeśli wypala go na nieskończonych kombinacjach filtrów, może nigdy nie dotrzeć do nowych produktów czy kluczowych landingów. Im większy serwis, tym bardziej jest zagrożony tym zjawiskiem.

Rozwodnienie . Jeśli jedne źródła linkują do /dresses?color=red, a inne do /dresses?size=m, sygnały mogą trafiać do różnych widoków. Konsoliduj tylko duplikaty i bardzo podobne strony; odrębne, wartościowe landingi mogą zbierać własne sygnały.

UX i CTR. Długie, „maszynowe" adresy (/products.php?cat=2&id=815) wyglądają na mniej wiarygodne (spamerskie), gorzej się je udostępnia czy klika niż czytelne i jasne np /buty/czerwone-trampki.

Widoczność w systemach AI. Oprócz Googlebota stronę mogą odwiedzać boty odpowiadające za wyszukiwanie w produktach AI, trening modeli lub pojedyncze żądania użytkowników. Przykładowo OpenAI rozróżnia OAI-SearchBot, GPTBot i ChatGPT-User, a każdy z nich ma inny cel. Nie należy więc zakładać jednego, wspólnego sposobu renderowania JavaScriptu dla wszystkich systemów. Praktyczna zasada pozostaje jednak bezpieczna: treść, którą chcesz indeksować lub cytować, powinna być dostępna w odpowiedzi HTML bez obowiązkowej interakcji użytkownika. To bezpośrednio łączy temat parametrów z audytem renderowania i indeksacji.

Parametry URL w React, Next.js i Astro a renderowanie

W aplikacjach JavaScript o losie parametrów decyduje architektura renderowania i w tej części, chce więcej opowiedzieć na ten temat.

Czysty React (SPA, CSR)

W Single Page Application zmiana filtra zwykle nie przeładowuje strony, ponieważ JavaScript przechwytuje akcję i podmienia treść przez History API. Możemy chwalić to rozwiązanie ze względu na UX, ale jest to ryzykownie dla SEO. Jeśli przefiltrowana treść powstaje wyłącznie po stronie klienta, bot, który nie wykona JS, zobaczy pustą lub niekompletną stronę. To problem architektoniczny na który sam canonical nie pomoże i najczęściej wymaga przejścia na renderowanie serwerowe.

Next.js App Router i pułapka searchParams

W Next.js (App Router) parametry zapytania trafiają do strony przez prop searchParams. Od Next.js 15 jest on asynchroniczny (Promise) i trzeba go await-ować w komponentach serwerowych:

Code
// app/produkty/page.tsx dla Next.js 15+
type Props = {
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>
}
 
export default async function ProduktyPage({ searchParams }: Props) {
  const { color, sort } = await searchParams
  return (
    <p>
      Kolor: {String(color ?? 'wszystkie')}; sortowanie:{' '}
      {String(sort ?? 'domyślne')}
    </p>
  )
}

searchParams zawiera dane konkretnego żądania. Bez Cache Components jego odczyt w stronie przełącza ją na renderowanie dynamiczne. Przy włączonych Cache Components w Next.js 16 można zachować prerenderowaną część strony, przekazując Promise do komponentu potomnego i odczytując go pod granicą Suspense. Znaczenie ma miejsce odczytu danych, a nie samo przekazanie propa.

Zmienia to model cache i koszt obsługi żądań, ale nie oznacza automatycznie gorszego TTFB. Separacja tras jest jedną z możliwości: wartościowe landingi mogą mieć osobne ścieżki, a filtry użytkowe odrębny widok. Możesz też zachować statyczną część strony i odizolować fragment zależny od żądania. Samo przeniesienie zapytania do Route Handlera nie gwarantuje, że wynik znajdzie się w HTML strony.

Dla elementu interfejsu, który może powstać dopiero w przeglądarce, użyj useSearchParams:

Code
// app/produkty/filter-controls.tsx
'use client'
import { useSearchParams } from 'next/navigation'
 
export function FilterControls() {
  const params = useSearchParams()
  const color = params.get('color')
  return <p>Wybrany kolor: {color ?? 'wszystkie'}</p>
}

Na trasie statycznej opakuj ten komponent w Suspense:

Code
// app/produkty/page.tsx — alternatywa dla wcześniejszej strony dynamicznej
import { Suspense } from 'react'
import { FilterControls } from './filter-controls'
 
export default function ProduktyPage() {
  return (
    <main>
      <h1>Produkty</h1>
      <Suspense fallback={<p>Ładowanie ustawień filtra…</p>}>
        <FilterControls />
      </Suspense>
    </main>
  )
}

Bez tej granicy produkcyjny build statycznej strony może zakończyć się błędem, choć development działa. W tym wariancie początkowy HTML zawiera fallback, a odczyt parametrów odbywa się po stronie klienta. Na trasie dynamicznej komponent z useSearchParams może jednak być renderowany również na serwerze — samo 'use client' nie oznacza braku serwerowego HTML.

Dla widoków przeznaczonych do indeksowania zapewnij treść i metadane generowane na serwerze; dla filtrów czysto użytkowych wariant kliencki może być wystarczający. To rozwinięcie zasady opisanej w tekście o tym, kiedy Next.js naprawdę daje przewagę SEO nad zwykłym Reactem.

Astro

W Astro o wszystkim decyduje tryb renderowania trasy. Domyślnie strony są prerenderowane (statyczne) i Astro.url.searchParams na etapie builda jest puste. Żeby reagować na parametry w czasie żądania, trasa musi działać w trybie serwerowym:

Code
---
// src/pages/produkty.astro
export const prerender = false // tryb on-demand (SSR)
const color = Astro.url.searchParams.get('color')
---

Samo prerender = false nie wystarczy w projekcie bez środowiska wykonawczego. Build musi korzystać z adaptera, np. Cloudflare, Netlify, Node lub Vercel. Alternatywnie cały projekt może działać z output: 'server'; wtedy trasy są domyślnie renderowane na żądanie, a statyczne wyjątki oznaczasz przez prerender = true.

To ta sama zasada co w Next.js, gdzie treść zależna od parametru wymaga renderowania w czasie żądania, jeśli ma być widoczna dla wyszukiwarek bez wykonywania JS.

Link kanoniczny w Astro ustawiasz bezpośrednio w layoucie lub w elemencie <head> komponentu. Framework nie ma odpowiednika generateMetadata, więc konsolidacja sygnałów dla sparametryzowanych widoków wymaga wyznaczenia właściwego URL kanonicznego. Poniższy przykład dotyczy wariantów równoważnych stronie bazowej i zakłada site: 'https://example.com' w astro.config.mjs:

Code
---
// src/pages/produkty.astro
export const prerender = false
const canonicalUrl = new URL('/produkty', Astro.site).toString()
---
<head>
  <link rel="canonical" href={canonicalUrl} />
</head>

Jeśli sparametryzowany widok ma być indeksowany jako samodzielna strona (np. /produkty?category=buty), link kanoniczny powinien wskazywać na siebie. Zbuduj adres na podstawie Astro.site, ścieżki i zatwierdzonych parametrów treściowych po normalizacji. Nie kopiuj bezwarunkowo domeny z bieżącego żądania przez Astro.url.href. Wartościowe filtry możesz też udostępnić jako osobne ścieżki (src/pages/produkty/[kategoria].astro), prerenderowane lub serwerowe zależnie od potrzeb.

Po zdiagnozowaniu parametrów dobiera się narzędzie do celu. Zanim sięgniesz po tabelę właściwości, warto przejść przez ścieżkę decyzji:

Diagram
Ścieżka decyzji: o doborze narzędzia decyduje intencja parametru, nie jego składnia.

Dla sortowania i filtrów porównaj rzeczywistą zawartość: bardzo podobny widok może wskazywać canonical do odpowiednika, ale inne zestawy wyników wymagają osobnej decyzji. robots.txt nie ogranicza dostępu użytkowników i nie gwarantuje usunięcia adresu z indeksu. Nieistniejące kombinacje powinny zwracać 404.

Z kolei tabela poniżej zestawia te narzędzia po właściwościach, czyli blokowaniu crawla, efekcie indeksacyjnym i konsolidacji sygnałów:

RozwiązanieBlokuje crawl?Efekt indeksacyjnyKonsoliduje sygnały?Główne zastosowanie
rel="canonical"NieWskazuje preferowany URL, bez gwarancjiTakDuplikaty i bardzo podobne widoki
robots.txt DisallowTakURL nadal może pojawić się bez treściNieOgraniczanie crawlowania wzorców
noindexNieUsuwa dostępną do crawlowania stronęNieWidoki dostępne, ale poza wynikami
Redirect 301/308NieZastępuje stary URL docelowymTakTrwała zmiana adresu
RewriteNiePubliczny URL pozostaje bez zmianNieWewnętrzne mapowanie żądania
Osobny landingNieMoże być samodzielnie indeksowanyNie sam w sobieWartościowe filtry z unikalną intencją

Dla wariantów różniących się tylko parametrami śledzącymi możesz wskazać adres bez tych parametrów. Przykład dotyczy pierwszej strony bazowej listy:

Code
// app/produkty/page.tsx
import type { Metadata } from 'next'
 
export async function generateMetadata(): Promise<Metadata> {
  return {
    alternates: {
      canonical: 'https://example.com/produkty', // czysty, bez parametrów
    },
  }
}

Pamiętaj też, że canonical to silna wskazówka, ale nie jest rozkazem dla Google. Jego celem jest porządkowanie indeksu, a sam Google i tak może odwiedzić niekanoniczny URL, więc nie jest to blokada crawlowania. Z czasem może jednak ograniczyć częstotliwość pobierania niekanonicznych wariantów.

Nie kopiuj jednak tego przykładu bezwarunkowo na każdą stronę, ponieważ paginacja powinna zachować ?page=2, a indeksowalny filtr powinien zachować własny URL. Generator powinien zachowywać parametry definiujące indeksowalną treść. Sortowania nie usuwaj automatycznie: /produkty?page=2&sort=price może zawierać inne produkty niż /produkty?page=2. Dla takich alternatywnych list rozważ noindex lub ograniczenie crawlowania.

Poniższy helper jest tylko etapem usuwania rozpoznanych parametrów śledzących, a nie pełną normalizacją:

Code
const TRACKING_PARAMS = new Set([
  'utm_source',
  'utm_medium',
  'utm_campaign',
  'utm_content',
  'utm_term',
  'gclid',
  'fbclid',
])
 
export function getCanonicalUrl(input: URL) {
  const canonical = new URL(input)
 
  for (const key of [...canonical.searchParams.keys()]) {
    if (TRACKING_PARAMS.has(key)) canonical.searchParams.delete(key)
  }
 
  canonical.searchParams.sort()
  canonical.hash = ''
  return canonical.toString()
}

Ten helper nie rozstrzyga indeksacji color=red, nie usuwa sort, nie normalizuje page=1 i nie scala powtórzonych wartości. sort() porządkuje klucze, zachowując kolejność wartości tego samego klucza. Lista parametrów śledzących jest przykładowa — dopasuj ją do używanej analityki. Decyzje indeksacyjne muszą wynikać z mapy typów stron.

Dla wyników wyszukiwarki wewnętrznej przeznaczonych poza indeks możesz ustawić dyrektywę w Next.js:

Code
// app/szukaj/page.tsx — dodaj obok komponentu strony
import type { Metadata } from 'next'
 
export const metadata: Metadata = {
  robots: { index: false },
}

W Astro odpowiednikiem w <head> jest:

Code
<meta name="robots" content="noindex" />

Te warianty wymagają dozwolonego crawlowania, aby bot mógł odczytać dyrektywę. Nie łącz ich z blokadą /szukaj pokazaną w alternatywnym przykładzie poniżej. Jeśli dyrektywa zależy od parametrów, wyznacz ją na serwerze zgodnie z regułami danego widoku.

robots.txt / robots.ts (Next.js)

Najskuteczniejsze narzędzie do oszczędzania budżetu indeksowania jest robots.txt:

Code
// app/robots.ts
import type { MetadataRoute } from 'next'
 
export default function robots(): MetadataRoute.Robots {
  return {
    rules: {
      userAgent: '*',
      allow: '/',
      disallow: ['/szukaj', '/*?sessionid=', '/*&sessionid='],
    },
    sitemap: 'https://example.com/sitemap.xml',
  }
}

Uważaj, by nie blokować plików .js/.css (uniemożliwisz wtedy renderowanie) i nie łącz Disallow z na tej samej stronie. Jeśli zablokujesz crawl, bot nigdy nie zobaczy noindex i strona może zostać w indeksie. Wybierz jedno albo drugie.

Wzorce dla parametrów zapytania trzeba testować na prawdziwych URL-ach. Parametr może wystąpić jako pierwszy po ? albo kolejny po &, dlatego jedna reguła często nie obejmuje obu przypadków. Jeszcze lepiej najpierw znormalizować kolejność parametrów i ograniczyć ich generowanie, zamiast próbować naprawić cały graf samym plikiem robots.txt.

Statyczne URL przez redirecty (Next.js)

Wartościowe filtry można przenieść na czytelne, osobne ścieżki. Nie jest to wymóg indeksowania ani deklaracja statycznego renderowania. Przy zmianie adresu usuń parametr przeniesiony do ścieżki, zachowując pozostałe potrzebne dane:

Code
// proxy.ts — Next.js 16; w Next.js 15: middleware.ts i funkcja middleware
import { NextResponse, type NextRequest } from 'next/server'
 
export function proxy(request: NextRequest) {
  const url = request.nextUrl.clone()
  const categories = url.searchParams.getAll('category')
 
  if (
    url.pathname === '/produkty' &&
    categories.length === 1 &&
    categories[0] === 'buty'
  ) {
    url.pathname = '/produkty/buty'
    url.searchParams.delete('category')
    return NextResponse.redirect(url, 308)
  }
 
  return NextResponse.next()
}
 
export const config = { matcher: '/produkty' }

Przykład zakłada istniejącą trasę /produkty/buty, która obsługuje zachowane filtry i paginację. UTM-y również pozostają dostępne do pomiaru atrybucji. Wielokrotne category wymagają osobnej reguły walidacji. Samo redirects() w next.config.js domyślnie przekazuje parametry zapytania dalej — zmiana ścieżki nie usuwa automatycznie category.

To podejście ma sens, gdy przefiltrowany widok („męskie buty do biegania") ma na tyle unikalną treść i potencjał wyszukiwawczy, że chcesz go indeksować jako samodzielną stronę.

Nie zastępuj redirectu przez , jeśli celem jest zmiana adresu widocznego dla użytkownika i wyszukiwarki. Rewrite może serwować zawartość /produkty/buty pod adresem /produkty?category=buty, ale nie przenosi przeglądarki i sam nie konsoliduje sygnałów. Jest narzędziem routingu, nie kanonikalizacji.

Normalizacja parametrów do jednego stanu i jednego URL-a

Najpierw aplikacja musi przestać generować wiele adresów opisujących dokładnie ten sam stan, a dopiero potem myślimy o linku kanonicznym.

Code
/produkty?color=red&size=m
/produkty?size=m&color=red
/produkty?color=RED&size=m
/produkty?color=red&size=m&utm_source=mail
/produkty?color=red&size=m&color=red

Warstwa normalizacji powinna:

  • Przyjmować tylko znane klucze i dozwolone wartości.
  • Usuwać wartości puste i domyślne tylko zgodnie z semantyką danego klucza; dla wielokrotnego wyboru usuwać powtórzenia tej samej wartości, nie wszystkie kolejne wartości.

  • Normalizować format i wielkość liter tylko tam, gdzie aplikacja uznaje warianty za równoważne; nie zmieniać bezwarunkowo identyfikatorów ani podpisanych tokenów.

  • Generować klucze w stałej kolejności; wartości wielokrotnego wyboru sortować tylko wtedy, gdy ich kolejność nie ma znaczenia.

  • Oddzielać parametry treściowe od śledzących.
  • Odrzucać kombinacje, których aplikacja nie obsługuje.

Jeśli wariant jest jednoznacznie tym samym zasobem, serwer może przekierować go kodem 308 do wersji znormalizowanej. Nieznany parametr można zignorować lub usunąć, jeśli nie zmienia zasobu. Dla nieistniejących kombinacji filtrów, kombinacji bez wyników i nieistniejących stron paginacji Google zaleca 404 pod żądanym adresem, zamiast pustego 200 lub przekierowania do wspólnej strony błędu. Dostępne, poprawne widoki użytkowe mogą natomiast mieć noindex.

Nawigacja fasetowa w e-commerce a budżet indeksowania

Najtrudniejszy przypadek nie zaczyna się przy jednym filtrze, tylko przy ich kombinacjach. Dziesięć atrybutów po dziesięć wartości daje potencjalnie miliardy stanów, zanim doliczysz sortowanie, paginację i kolejność parametrów. Googlebot musi najpierw odwiedzić URL, żeby ocenić jego przydatność, więc niekontrolowany graf filtrów spowalnia odkrywanie właściwych stron i obciąża serwer.

Dojrzała architektura rozdziela trzy klasy widoków:

Klasa widokuPrzykładDecyzja
Landing o potwierdzonym popycie/buty/bieganie/meskie/Stały URL, unikalna treść, link kanoniczny do samej siebie, linkowanie wewnętrzne
Filtr użytkowy bez osobnej intencji?sort=price&availability=1Dostępny dla użytkownika; canonical tylko dla podobnej treści, inaczej noindex lub kontrola crawla
Kombinacja bez wartości?color=red&color=blue&size=noneBrak linkowania, normalizacja, blokada wzorca lub odpowiedź 404

Nie ma jednej reguły Disallow, która poprawnie rozpozna wartość biznesową kombinacji. Lista indeksowalnych landingów powinna być jawna i ograniczona, a interfejs filtrów nie może generować linków do każdego matematycznie możliwego stanu. W dużym e-commerce dochodzi jeszcze kontrola głębokości, liczby aktywnych filtrów oraz parametrów zależnych, więc na przykład rozmiar nie powinien generować URL-i dla kategorii, w której nie występuje. Sama implementacja takiego interfejsu filtrów po stronie aplikacji, z searchParams, debounce i synchronizacją stanu z URL, to osobny temat, który rozwijam w artykule o wyszukiwarce z filtrami w Next.js.

Odkrywanie URL-i przez crawlera przez linkowanie i sitemap

Google zwykle znajduje kolejne strony przez href elementu <a>, a nie przez kliknięcie przycisku uruchamiającego JavaScript i dlatego właśnie paginacja i indeksowalne filtry muszą mieć prawdziwe, serwerowo renderowane linki.

Zasady są spójne w całym serwisie:

  • linkowanie wewnętrzne prowadzi do wersji kanonicznych i nie dokleja UTM-ów,
  • sitemap zawiera tylko adresy kanoniczne, zwracające 200 i przeznaczone do indeksacji,
  • parametry sortowania, sesji i kampanii nie trafiają do sitemap,
  • indeksowalne landingi są osiągalne z kategorii lub innych stron tematycznych,
  • przycisk „pokaż więcej” i infinite scroll mają równoległą sekwencję crawlable URL-i.

Samą generację poprawnej sitemap, tylko z adresami kanonicznymi i bez parametrów śledzących, automatyzujesz po stronie frameworka. Pokazuję to w praktyce dla sitemap i robots.txt w Next.js oraz dla dynamicznej sitemap w Astro.

Dwa fakty, które dezaktualizują wiele starszych poradników:

  1. Google nie używa już rel="next"/rel="prev" do łączenia serii paginowanych (oficjalnie od 2019). Możesz je zostawić dla dostępności, ale nie licz na efekt SEO.
  2. Narzędzie URL Parameters w Google Search Console zostało wycofane (2022). Dziś obsługą parametrów sterujesz wyłącznie po swojej stronie: canonical, robots.txt, noindex, struktura linków.

Dla paginacji rekomendacja jest prosta. Każda strona serii powinna mieć samoreferencyjny link kanoniczny (/kategoria?page=2 wskazuje linkiem kanonicznym na /kategoria?page=2). Częsty błąd to ustawianie linku kanonicznego wszystkich stron na stronę 1, ponieważ sugerujesz, że strony 2, 3, 4 są duplikatami, choć zawierają inne elementy. To błędny sygnał indeksacyjny; canonical sam nie blokuje pobierania tych stron ani odkrywania ich linków.

Link kanoniczny to jednak tylko część wdrożenia. Każda strona musi mieć unikalny URL, link <a href> prowadzący co najmniej do następnej strony oraz możliwość powrotu do początku kolekcji. Infinite scroll może zostać jako warstwa UX, ale nie może być jedyną drogą do dalszych elementów, ponieważ crawler nie wykonuje gestu przewijania ani nie klika przycisku „więcej”. Stronę implementacyjną, w tym wybór między offsetem, cursorem a stanem w URL przez searchParams, rozkładam na czynniki w artykule o paginacji w Next.js.

Trzeba też określić zachowanie brzegowe:

  • ?page=1 przekieruj do czystego URL-a kategorii,
  • ?page=0, wartości tekstowe i liczby ujemne normalizuj lub odrzucaj,
  • strona wykraczająca poza ostatnią stronę powinna zwracać 404,
  • zmiana sortowania nie może przypadkowo zmieniać linku kanonicznego paginacji na stronę 1,
  • filtry aktywne na stronie 2 muszą być zachowane w linkach kolejnych stron, jeśli tworzą jeden spójny widok.

Najczęstsze błędy w obsłudze parametrów URL

Parametry dla stron nawigacyjnych oznaczają na przykład ?page_id=2 zamiast /o-nas/. Statyczne strony powinny mieć czyste URL-e z wyraźnymi, przyjaznymi użytkownikowi słowami kluczowymi (friendly urls).

Niespójne linkowanie wewnętrzne pojawia się wtedy, gdy menu linkuje do /dresses, a baner do /dresses?sort=newest. Zawsze linkuj wewnętrznie do czystej, kanonicznej wersji.

Konflikt robots.txt + noindex jest opisany wyżej; bot nie zobaczy noindex, jeśli wcześniej zablokujesz crawl.

Globalny link kanoniczny na paginacji omawia sekcja o paginacji.

Nieskończone przestrzenie URL powstają na przykład przez możliwość dodania tego samego filtra wielokrotnie (?color=red&color=blue&color=red...). To pułapka na crawlery i musisz ograniczyć poprzez logikę serwerową i wzorce parametrów w robots.txt.

Ignorowanie kolejności parametrów sprawia, że ?color=blue&size=m i ?size=m&color=blue to dla bota dwa różne URL-e. Musisz wymusić spójną, deterministyczną kolejność generowania parametrów.

Puste wyniki z kodem 200 oznaczają sytuację, w której kombinacja filtrów nie zwraca produktów, ale nadal generuje indeksowalną stronę z tytułem kategorii. Przy dużej liczbie kombinacji powstają tysiące thin pages. Nieistniejący stan powinien mieć jawnie zaprojektowaną odpowiedź, zamiast dziedziczyć metadata strony bazowej.

Niespójne sygnały występują wtedy, gdy link kanoniczny wskazuje czysty URL, sitemap zawiera wariant z parametrem, a linkowanie wewnętrzne prowadzi do jeszcze innej wersji. Jednym słowem, jest bałagan. Google dostaje trzy konkurencyjne wskazówki i może wybrać link kanoniczny inny od deklarowanego.

Fragmentacja cache pojawia się, gdy CDN lub warstwa aplikacyjna traktuje każdą kolejność parametrów jako osobny klucz cache. Nawet gdy HTML jest identyczny, rośnie liczba missów, czas odpowiedzi i koszt infrastruktury. Normalizacja musi działać przed generowaniem klucza cache, a nie dopiero w tagu linku kanonicznego.

Błędy specyficzne dla JS:

  • odczyt searchParams bez uwzględnienia modelu renderowania i granic Suspense → zmiana zakresu prerenderowania lub błąd buildu; wpływ na wydajność trzeba zmierzyć,
  • kluczowa treść filtrów wyłącznie po stronie klienta → zależna od możliwości wykonania JavaScriptu przez konkretnego crawlera,
  • link kanoniczny/metadane zależne od parametru wstrzykiwane po stronie klienta zamiast renderowane serwerowo.

Co powinien wykazać audyt parametrów URL

Sama lista adresów z ? nie jest audytem. Wynikiem powinna być mapa reguł łącząca semantykę parametrów, zachowanie aplikacji i decyzję indeksacyjną. Do jej zbudowania potrzebne są cztery źródła danych:

  • Crawler pokazuje wzorce generowane przez linkowanie i liczbę osiągalnych kombinacji.
  • Google Search Console pokazuje URL-e znalezione przez Google, wybrany link kanoniczny i problemy z indeksacją.
  • Logi serwera ujawniają faktyczne zachowanie Googlebota, częstotliwość wejść i kombinacje pochłaniające zasoby. Jak czytać te dane na poziomie crawlowania, pokazuję na przykładzie logów Cloudflare i budżetu indeksowania.
  • Analityka i dane biznesowe odróżniają filtry używane i konwertujące od technicznego szumu.

Rezultatem nie powinien być PDF z ogólnym „dodaj link kanoniczny”. Potrzebna jest macierz: wzorzec URL → status HTTP → robots → link kanoniczny → obecność w sitemap → zasady linkowania → renderowanie → właściciel reguły w kodzie. Dopiero na tej podstawie można bezpiecznie zmienić robots.ts, Metadata API, routing i komponent filtrów. Pisałem o tym szerzej: audyt SEO to nie lista TODO, tylko pull requesty.

Kryteria odbioru wdrożenia obsługi parametrów

Zmiana jest zakończona dopiero wtedy, gdy zachowanie zgadza się w kodzie, renderowanym HTML-u i logach. Kryteria odbioru powinny obejmować:

  1. Każdy wspierany wzorzec zwraca oczekiwany status HTTP.
  2. Link kanoniczny jest absolutny, stabilny i zgodny z sitemap oraz linkowaniem.
  3. Widoki noindex pozostają dostępne dla crawlera, który ma odczytać dyrektywę.
  4. Zablokowane wzorce nie są jednocześnie promowane w linkach i sitemap.
  5. Paginacja jest osiągalna przez linki bez wykonywania interakcji.
  6. Normalizacja nie usuwa parametrów potrzebnych do działania produktu lub atrybucji.
  7. Logi po wdrożeniu pokazują spadek wejść w bezwartościowe kombinacje bez utraty crawlowania ważnych landingów.

Te reguły warto zabezpieczyć testami regresji dla reprezentatywnych typów stron, a nie tysiącami snapshotów pojedynczych URL-i. Przykład takiej warstwy opisuję w artykule o automatycznych testach regresji SEO w CI/CD.

Strategia obsługi parametrów: e-commerce vs mała strona

Nie ma jednego idealnego ustawienia, a strategia zależy przede wszystkim od kontekstu, skali oraz celów.

  • Duży sklep e-commerce wymaga przede wszystkim kontroli grafu URL-i i zasobów serwera. Ograniczaj odkrywanie parametrów niskiej wartości, a wybrane wzorce blokuj w robots.txt tylko wtedy, gdy nie potrzebujesz na nich dyrektywy noindex. Wartościowym filtrom zapewnij stabilne, indeksowalne adresy i deterministyczną kolejność parametrów; osobne ścieżki są jedną z możliwości.
  • Mniejsza strona firmowa / usługowa rzadko ma problem z budżetem indeksowania, dlatego skup się na konsolidacji link equity przez canonical i na czystej strukturze URL. Najczęściej wystarczy kilka reguł.

Jednej rzeczy unikaj i mam tu na myśli globalnego Disallow: /*?*. To wyjątkowo tępawe narzędzie. Potrafi zablokować wartościowe, sparametryzowane landingi i wersje językowe, a do tego odcina Google od canonical/noindex na tych stronach. Prawie zawsze lepsze jest podejście celowane.

Jak podchodzę do tego w StriveLab

Parametry URL to dla mnie część szerszego audytu technicznego SEO, bo w aplikacjach Next.js, React i Astro ich obsługa zazębia się z renderowaniem, indeksacją i . Mój układ pracy:

  • diagnoza obejmuje crawler, GSC, logi i GA4, żeby oddzielić parametry wartościowe od śmieci,
  • decyzja per typ określa, co kanonizować, co blokować, co przenieść na osobną ścieżkę, a co indeksować jako landingi,
  • wdrożenie w kodzie obejmuje canonical przez Metadata API, robots.ts, redirects/rewrites i separację tras pod SSG bezpośrednio w repozytorium, nie jako listę TODO,
  • pomiar przed i po obejmuje indeksację w GSC, crawl w logach i performance po zmianach.
Audyt techniczny i optymalizacja SEO.
Audyt techniczny SEO

Często zadawane pytania

Czym różni się parametr URL od parametru UTM?

Parametr UTM to szczególny rodzaj parametru URL. Parametr URL to ogólny termin na każdą parę klucz-wartość w adresie (sortowanie, filtrowanie itd.). UTM to wystandaryzowany zestaw parametrów pasywnych używany wyłącznie do śledzenia kampanii marketingowych i nie zmienia treści strony.

Czy Google indeksuje adresy URL z parametrami?

Tak. Problem nie polega na tym, że nie może, tylko na tym, że często robi to bez kontroli, co prowadzi do duplikacji treści i marnowania budżetu indeksowania. Dobra obsługa parametrów polega na świadomym sterowaniu tym, które adresy trafiają do indeksu.

Czy w Next.js sięganie po searchParams szkodzi SEO?

Nie bezpośrednio. Odczyt searchParams wymaga danych konkretnego żądania. Bez Cache Components przełącza stronę na renderowanie dynamiczne; przy Cache Components można zachować prerenderowaną część strony i wydzielić odczyt parametrów pod granicą Suspense. Nie oznacza to automatycznie wolnej strony, ale zmienia model cache i koszt obsługi żądania. Ryzyko SEO pojawia się wtedy, gdy parametry tworzą duplikaty, pogarszają stabilność odpowiedzi albo kluczowa treść istnieje wyłącznie po stronie klienta.

Czy powinienem zablokować wszystkie parametry przez Disallow?

Prawie nigdy. Globalny Disallow: /*?* potrafi ograniczyć crawlowanie, ale jest zbyt szeroki, ponieważ może zablokować wartościowe filtry, wersje językowe (?lang=) i odciąć Google od canonical lub noindex na tych stronach. Lepsze jest podejście bardziej precyzyjne, by określić intencję każdego parametru i blokować tylko bezwartościowe wzorce, a duplikaty kanonizować.

Jak obsłużyć paginację pod kątem SEO w 2026?

Każda strona serii powinna mieć unikalny URL i samoreferencyjny canonical (strona 2 wskazuje na siebie, nie na stronę 1). Kolejne strony muszą być osiągalne przez zwykłe linki <a href>, również wtedy, gdy interfejs używa infinite scroll. rel=next/prev nie jest już używane przez Google do indeksacji, a narzędzie URL Parameters w Search Console zostało wycofane.

Czy crawlery AI (ChatGPT, Perplexity) widzą treść zależną od parametrów?

Najbezpieczniej założyć, że treść przeznaczona do cytowania powinna znaleźć się w HTML-u zwracanym przez serwer. Możliwości wykonywania JavaScriptu różnią się między crawlerami i mogą się zmieniać, dlatego kluczowej treści nie warto uzależniać wyłącznie od interakcji po stronie klienta. Dodatkowo trzeba rozróżniać boty wyszukujące, treningowe i uruchamiane na żądanie użytkownika, ponieważ nie pełnią tej samej funkcji.

Link kanoniczny, noindex czy robots.txt, czym się różnią?

Każde z nich dobiera się do określonego celu, tak z resztą jak każde narzędzie. canonical konsoliduje sygnały duplikatów do jednej strony i nie blokuje crawlowania. noindex usuwa stronę z wyników, ale wymaga, by bot mógł ją scrawlować, a robots.txt blokuje crawlowanie i najlepiej oszczędza budżet indeksowania, ale nie konsoliduje sygnałów i uniemożliwia odczyt noindex.

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
Google Search Console w Next.js: indeksacja, błędy i raporty

Trudno wyobrazić sobie współczesną analitykę bez Google Search Console GSC , czyli podstawowego narzędzia pokazującego dane bezpośrednio z Google Search. PageSpeed Insights mierzy wydajność, Ahrefs śledzi backlinki, ale GSC pokazuje dane o widoczności i problemach dotyczących strony internetowej. Dowiesz się z niego, które strony Google zna i indeksuje, jakie błędy crawlowania występują, na jakie frazy rankujesz oraz jakie wyniki Core Web Vitals osiąga strona podczas rzeczywistych wizyt użytkowników.

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

Wyszukiwarka z filtrami w Next.js: searchParams i URL state

Użytkownik ustawia trzy filtry, znajduje idealny wynik i wysyła link koledze, jednak ten widzi pustą wyszukiwarkę. Dzieje się tak, ponieważ stan filtrów przechowywany w useState nie opuszcza przeglądarki. Przeniesienie stanu do adresu URL rozwiązuje ten problem u źródła: zatwierdzone filtry stają się częścią linku, dzięki czemu przetrwają odświeżenie strony, udostępnienie oraz użycie przycisku „wstecz”, a przy tym są w pełni czytelne dla Server Components. Pokazuję, jak zbudować taką wyszukiwarkę — z debounce , skeletonami oraz walidacją parametrów i SEO.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G