Skip to main content
Moje marki: PozycjonowanieStron.pl · PozycjonowanieStrony.pl · Tworzeniestronwww.pl
Fundacja Usuwanie Hejtu
Techniczne SEO

SEO dla JavaScript i SPA – React, Next.js, Vue widoczne w Google

SEO dla JavaScript to doprowadzenie strony zbudowanej w React, Next.js, Vue, Nuxt, Angular lub innym frameworku do stanu, w którym Google widzi tę samą treść i te same linki co użytkownik – od razu, bez czekania na renderowanie. Jest dla firm, których nowoczesna aplikacja wygląda świetnie, ale nie pojawia się w wynikach wyszukiwania. Dostajesz diagnozę różnic między surowym HTML a wyrenderowaną stroną oraz wytyczne dla programistów.

ŁW Łukasz Wudyka ekspert SEO · Prezes Fundacji Usuwanie Hejtu
Aktualizacja:
ok. 7 min czytania

W skrócie

  • Googlebot wykonuje JavaScript, ale renderowanie jest odroczone i kosztowne, więc treść w surowym HTML indeksuje się szybciej i pewniej.
  • Linki muszą być elementami <a> z atrybutem href; nawigacja po kliknięciu w JavaScript jest dla robota niewidoczna.
  • Renderowanie po stronie serwera (SSR) lub statyczne (SSG) rozwiązuje większość problemów z indeksacją SPA.
  • Treść ładowana po przewinięciu lub kliknięciu zakładki nie zostanie zaindeksowana, jeśli nie ma jej w DOM po wczytaniu.

Jak to działa i dlaczego ma znaczenie

Gdy robot Google pobiera stronę, najpierw czyta surowy HTML. Jeśli znajdzie w nim treść, linki i meta tagi, może zaindeksować ją od razu. Jeśli HTML zawiera tylko pusty kontener i skrypty, strona trafia do kolejki renderowania, gdzie Google uruchamia ją w przeglądarce opartej na aktualnym Chromium i dopiero wtedy widzi treść. Ta kolejka może trwać od sekund do dni, a przy błędach skryptów, zablokowanych zasobach lub treści zależnej od interakcji renderowanie kończy się pustą stroną. Moja praca to sprawdzenie, co dokładnie widzi robot na każdym szablonie, i doprowadzenie do tego, by widział wszystko.

Przez ostatnie lata frameworki dojrzały do SEO: Next.js, Nuxt, SvelteKit, Astro i Remix domyślnie oferują renderowanie po stronie serwera lub statyczne generowanie stron, a React Server Components ograniczają ilość JavaScriptu wysyłanego do przeglądarki. Problemem przestał być brak narzędzi, a stało się ich niewłaściwe użycie: strony generowane po stronie klienta „bo tak było szybciej”, dane pobierane dopiero po hydracji, meta tagi ustawiane skryptem po wczytaniu. Do tego doszły roboty wyszukiwarek AI, które w większości w ogóle nie wykonują JavaScriptu, więc aplikacja bez SSR jest dla nich niewidoczna.

Typowy przypadek: sklep na React z API, w którym lista produktów w kategorii pobiera się po załadowaniu strony, a stronowanie działa przez przycisk „pokaż więcej”. Google widzi pustą kategorię i żadnego linku do produktów. Drugi: serwis na Next.js z poprawnym SSR, ale z komponentem, który po hydracji podmienia tytuł i opis na wartości domyślne. W obu przypadkach użytkownik niczego nie zauważa, a wyniki wyszukiwania są puste.

Kiedy potrzebujesz tej usługi

  • W wynikach Google strona wyświetla się z tytułem aplikacji zamiast tytułu podstrony, albo z pustym opisem.
  • Test adresu w Search Console pokazuje wyrenderowany HTML bez treści, która jest widoczna w przeglądarce.
  • Podstrony produktów lub artykułów nie trafiają do indeksu, choć działają po wpisaniu adresu.
  • Po przejściu z klasycznego CMS na aplikację JavaScript ruch organiczny spadł, mimo zachowania treści.
  • Narzędzie do podglądu bez JavaScriptu pokazuje pustą stronę z jednym kontenerem.

Co dokładnie robię

01

Porównanie surowego HTML z wyrenderowanym DOM

Dla każdego szablonu sprawdzam, co jest w odpowiedzi serwera, a co pojawia się dopiero po wykonaniu skryptów: treść, linki, nagłówki, meta tagi, dane strukturalne.

02

Test renderowania przez Google

Używam testu adresu w Search Console i testu wyników z elementami rozszerzonymi, żeby zobaczyć stronę oczami robota i wykryć błędy skryptów oraz zablokowane zasoby.

03

Strategia renderowania

Rekomenduję SSR, SSG, ISR lub hybrydę per typ strony: statyczne dla treści, serwerowe dla kategorii i produktów, klienckie tylko dla paneli użytkownika.

04

Linki i nawigacja

Weryfikuję, czy wszystkie linki są elementami <a href>, czy stronowanie i filtry mają własne adresy, czy menu nie opiera się na zdarzeniach kliknięcia.

05

Meta tagi, canonical i dane strukturalne

Pilnuję, by tytuł, opis, canonical, hreflang i JSON-LD były w HTML z serwera i nie były nadpisywane po hydracji.

06

Routing i kody odpowiedzi

Sprawdzam, czy nieistniejące adresy zwracają 404, czy przekierowania działają na serwerze, a nie w JavaScript, i czy adresy nie zawierają fragmentów z krzyżykiem.

07

Wydajność i hydracja

Mierzę ilość JavaScriptu, czas hydracji i INP; wskazuję, które komponenty mogą być serwerowe lub wczytywane leniwie.

08

Wytyczne i weryfikacja z zespołem

Dokument dla programistów z przykładami kodu i listą kontrolną; po wdrożeniu powtarzam testy na środowisku testowym i produkcji.

Jak przebiega współpraca

  1. 1
    tydzień 1

    Diagnoza szablonów

    Testuję każdy typ strony w trzech wersjach: surowy HTML, wyrenderowany DOM, widok robota Google; spisuję różnice.

  2. 2
    tydzień 2

    Rekomendacje i warsztat z programistami

    Przekazuję strategię renderowania, listę poprawek i omawiam ją z zespołem, żeby wybrać rozwiązania zgodne z architekturą.

  3. 3
    tydzień 3–6

    Wdrożenie i testy

    Zespół wdraża zmiany na środowisku testowym; ja sprawdzam renderowanie, linki i meta tagi przed publikacją.

  4. 4
    tydzień 7–10

    Publikacja i monitoring indeksacji

    Po starcie śledzę raport indeksowania i statystyki robota, zgłaszam mapy XML i kluczowe adresy do ponownego sprawdzenia.

Czego się spodziewać i kiedy

Horyzont Co się dzieje Czym to mierzę
2 tygodnie Wiesz dokładnie, czego robot nie widzi i jak to naprawić w Waszym frameworku. Lista różnic HTML–DOM per szablon, dokument wytycznych.
1–2 miesiące Po wdrożeniu SSR lub poprawek treść i linki są w surowym HTML; Google indeksuje podstrony bez kolejki renderowania. Test adresu w Search Console, liczba zaindeksowanych adresów, czas od publikacji do indeksacji.
2–4 miesiące Podstrony pojawiają się w wynikach z poprawnymi tytułami i opisami; rośnie ruch na kategoriach i produktach. Wyświetlenia i kliknięcia w Search Console, ruch organiczny w GA4.

Koszt i model rozliczenia

Model projekt – diagnoza w stałej cenie, wsparcie wdrożenia godzinowo
Co wpływa na cenę
  • Framework i obecna strategia renderowania
  • Liczba szablonów i typów stron
  • Czy wymagana jest zmiana architektury (np. przejście na SSR), czy tylko poprawki
  • Zakres wsparcia dla zespołu programistów po diagnozie

Wycena diagnozy zawiera testy wszystkich szablonów, dokument wytycznych z przykładami i warsztat z programistami. Opisz projekt, a dostaniesz wycenę z zakresem prac rozpisanym na etapy.

Najczęstsze błędy, które widzę

  • Nawigacja oparta na onClick z przekazaniem adresu w JavaScript zamiast elementów <a href>.
  • Treść pobierana z API dopiero po hydracji, przez co surowy HTML zawiera pusty kontener.
  • Blokowanie w robots.txt katalogu ze skryptami lub API, bez których robot nie wyrenderuje strony.
  • Renderowanie wstępne tylko dla Googlebota (dynamic rendering) jako rozwiązanie docelowe – Google traktuje to jako obejście, nie zalecany standard.

Kiedy tego nie polecam

  • Strona działa na klasycznym CMS z odrobiną JavaScriptu do interakcji – problem indeksacji leży gdzie indziej; zacznij od audytu technicznego.
  • Aplikacja jest panelem po zalogowaniu bez treści publicznych – nie ma czego indeksować; SEO dotyczy tylko strony marketingowej.
  • Zespół planuje przepisać aplikację za kilka miesięcy – lepiej wpisać wymagania renderowania do nowego projektu niż naprawiać obecny.

Pytania i odpowiedzi

Czy Google indeksuje strony w JavaScript?

Tak, Googlebot renderuje JavaScript w aktualnej wersji Chromium. Robi to jednak z opóźnieniem i ograniczonym budżetem, więc treść dostępna dopiero po wykonaniu skryptów indeksuje się wolniej i mniej niezawodnie niż treść w HTML z serwera.

Co to jest SSR i czy jest potrzebne do SEO?

Server-Side Rendering to generowanie pełnego HTML na serwerze przy każdym żądaniu, tak że robot i użytkownik od razu dostają treść. Dla stron, które mają rankować, jest to najpewniejsze rozwiązanie; dla treści rzadko zmienianych wystarczy generowanie statyczne (SSG).

Czy Next.js jest dobry dla SEO?

Tak, pod warunkiem użycia renderowania serwerowego lub statycznego dla stron publicznych i pilnowania meta tagów oraz linków. Sam framework nie gwarantuje widoczności – widziałem serwisy na Next.js, które wszystko renderowały po stronie klienta.

Dlaczego Google widzi inny tytuł niż w przeglądarce?

Najczęściej tytuł jest ustawiany skryptem po wczytaniu, a robot zapisuje wersję z surowego HTML albo z momentu renderowania przed podmianą. Tytuł, opis i canonical powinny być w HTML z serwera.

Czy wyszukiwarki AI i ChatGPT widzą strony w JavaScript?

Większość robotów modeli językowych nie wykonuje JavaScriptu i czyta tylko surowy HTML. Aplikacja bez SSR jest dla nich pusta, co ma znaczenie, jeśli zależy Ci na cytowaniach w odpowiedziach AI.

ŁW
Łukasz Wudyka – autor

Ekspert SEO i ochrony wizerunku w internecie z ponad dziesięcioletnią praktyką. Prezes Fundacji Usuwanie Hejtu. Prowadzi własne serwisy, na których testuje metody, zanim zaproponuje je klientom. Komentuje algorytmy Google i hejt w sieci dla mediów. Więcej o mnie

Następny krok

SEO dla JavaScript / SPA – zacznijmy od diagnozy

Opisz, co ma się zmienić. Odpowiem, co da się zrobić, w jakim czasie i za ile.