Crawler SEO do JavaScriptu: jak crawlować witrynę w JavaScripcie
Witryna zbudowana w React, Vue, Angular czy Next.js może wyglądać idealnie w przeglądarce, a mimo to podawać crawlerom niemal pustą stronę. Crawler SEO do JavaScriptu pokazuje obie wersje, HTML wysłany przez serwer i stronę po uruchomieniu skryptów, oraz miejsca, w których się różnią.
Dlaczego witryny w JavaScripcie wymagają innego crawla
Google przetwarza strony w JavaScripcie w trzech fazach: crawl, renderowanie w bezgłowym Chromium, gdy ma na to zasoby, a potem indeksowanie. Podstawy SEO dla JavaScriptu od Google wyjaśniają kolejkę między crawlem a renderowaniem. Dopóki renderowanie nie nastąpi, Google pracuje na surowym HTML.
Inne crawlery mogą nigdy nie renderować. Wiele crawlerów AI i niektóre wyszukiwarki czytają tylko HTML wysłany przez serwer. Prawdziwe pytanie brzmi więc: czego brakuje przed renderowaniem i czy coś zmienia się po drodze.
Zwykły crawler HTML widzi tylko surową odpowiedź. Crawler SEO do JavaScriptu wczytuje każdą stronę w prawdziwej przeglądarce, czeka, aż się ustabilizuje, i trzyma obie wersje obok siebie. SEO ProCheck krok po kroku wyjaśnia, jak wyszukiwarki i crawlery AI renderują twoje strony.
Strony renderowane po stronie klienta, po stronie serwera, statyczne i z hydracją
Sposób, w jaki witryna buduje strony, decyduje o tym, co powinien zawierać surowy HTML.
| Jak zbudowana jest strona | Surowy HTML zawiera | Tekst bez JavaScriptu | Typowa konfiguracja |
|---|---|---|---|
| Renderowanie po stronie klienta | Główny div, tagi script | – | Aplikacja w React, Vue lub Angular |
| Renderowanie po stronie serwera | Pełną stronę | ✓ | Next.js, Nuxt, Angular SSR |
| Generowanie statyczne | Pełną stronę, zbudowaną wcześniej | ✓ | Eksporty statyczne, generatory witryn |
| Hydracja | Pełną stronę, potem skrypty | ✓ | Większość witryn na frameworkach |
| Mieszane | Zależy od szablonu | ◐ | Większość prawdziwych witryn |
Witryna w Next.js może serwować strony produktów z serwera, a wyniki wyszukiwania czy strony konta budować w przeglądarce. Dlatego sprawdzasz każdy szablon osobno: jeden szablon renderowany po stronie klienta może ukryć tysiące adresów URL.
Wyrenderowany a surowy HTML: co porównać
Porównuj element po elemencie. Dla każdego: czy w ogóle jest w surowym HTML i czy JavaScript go zmienia?
| Element | Ryzyko, gdy jest tylko po renderowaniu | Test w Neova |
|---|---|---|
| Tytuł | Strona nie ma nazwy | Tytuł jest tylko w wyrenderowanym HTML |
| Meta description | Brak źródła snippetu | Meta description pojawia się tylko w wyrenderowanym HTML |
| H1 | Brak widocznego tematu | H1 pojawia się tylko w wyrenderowanym HTML |
| Canonical | Dwa różne sygnały | Canonical zmieniany lub usuwany przez JavaScript |
| Noindex | Google może pominąć renderowanie | Dyrektywa noindex jest usuwana przez JavaScript |
| Linki wewnętrzne | Znalezione późno albo nigdy | Linki wewnętrzne są tylko w wyrenderowanym HTML |
| Główny tekst | Ubogi surowy HTML | Większość głównego tekstu jest tylko w wyrenderowanym HTML |
Dane strukturalne i hreflang też mogą być wstrzykiwane przez skrypty. Sprawdź, czy są obecne i identyczne w obu wersjach. Najbezpieczniejszy wzorzec jest nudny: wszystko, co ważne dla wyszukiwania, jest w HTML z serwera, a JavaScript dodaje tylko interakcję.
Liczby, które mają znaczenie w witrynie w JavaScripcie
| Limit | Wartość | Źródło |
|---|---|---|
| HTML pobierany przez Googlebot z każdego pliku | Pierwsze 15 MB | |
| Oznaczany czas renderowania | Ponad 4 sekundy | Renderowanie JavaScript trwa ponad 4 sekundy |
| Główny tekst tylko w wyrenderowanym HTML | Ponad połowa, 50+ słów | Grupa stron zależy od renderowania JavaScript w głównej treści lub nawigacji |
| Linki nawigacji tylko po renderowaniu | Połowa lub więcej | Grupa stron zależy od renderowania JavaScript w głównej treści lub nawigacji |
| Trasy z hashem wysyłane do serwera | Nic po znaku # | RFC 3986 |
Progi 4 sekund i połowy tekstu to progi Neova, podane w regule każdego testu. 15 MB i zasada fragmentu pochodzą od Google i ze standardu URI.
Jak skonfigurować crawl SEO witryny w JavaScripcie
- Najpierw crawluj bez renderowania. Szybki surowy crawl pokazuje, co wysyła serwer. Jeśli znajduje bardzo mało stron, nawigacja prawdopodobnie wymaga JavaScriptu.
- Renderuj próbkę z każdego szablonu. Kilka stron z każdej grupy stron pokazuje, które szablony zależą od skryptów. Całą witrynę renderuj tylko tam, gdzie zależą.
- Daj stronom się ustabilizować. Poczekaj, aż sieć ucichnie, a strona przestanie się zmieniać.
- Nie blokuj skryptów. Zobacz Strona HTML używa pliku JavaScript zablokowanego w robots.txt.
- Utrzymuj kulturalne tempo. Jedna wyrenderowana strona może oznaczać dziesiątki żądań o skrypty, style i wywołania API.
- Czytaj też błędy. Zobacz Renderowanie JavaScript nie powiodło się lub przekroczyło limit czasu.

Poradnik jak crawlować witrynę omawia zakres, szybkość i zgodę.
Typowe problemy SEO z JavaScriptem, które znajduje crawler
- Linki, które nie są linkami. Google podąża za elementami
az atrybutemhref. Przycisk z obsługą kliknięcia nie jest linkiem. Zobacz poradnik Google o crawlowalnych linkach. - Trasy za hashem.
/#/productswygląda jak jedna strona, bo część po hashu nigdy nie dociera do serwera. Używaj History API i prawdziwych ścieżek. - Soft 404. Aplikacja jednostronicowa często odpowiada 200 na każdą trasę, a potem pokazuje w przeglądarce komunikat o braku strony.
- Treść, która czeka na kliknięcie lub przewinięcie. Crawlery nie klikają zakładek. Uwagi Google o treści ładowanej leniwie pokazują, jak ją wczytać, aby została zaindeksowana.
- Metadane zablokowane na pierwszej trasie. Title i canonical zachowują wartości pierwszej strony, jeśli router ich nie aktualizuje.
- Przekierowania w JavaScripcie. Są wychwytywane wolniej niż przekierowania serwerowe, a niektóre crawlery nigdy ich nie widzą.
- Błędy, które usuwają treść. Jedno nieudane wywołanie API może zostawić stronę bez tytułu lub głównego tekstu. Zobacz Błędy JavaScript usuwają po renderowaniu tytuł, canonical lub główny tekst.
Więcej odpowiedzi w FAQ SEO ProCheck o SEO dla JavaScriptu.
Crawlowanie witryn w React, Next.js i aplikacji jednostronicowych
Aplikacja jednostronicowa. Spodziewaj się prawie pustego surowego HTML i małego surowego crawla. Wyrenderuj próbkę każdego typu trasy i sprawdź, czy każda trasa ma własny URL, title i canonical oraz prawdziwy status 404 dla nieistniejących stron. Renderowanie po stronie serwera lub generowanie statyczne to poprawka, która pomaga od razu wszystkim crawlerom.
Witryna w Next.js lub Nuxt. Większość stron jest już w surowym HTML. Szukaj wyjątków: tras budowanych w przeglądarce, metadanych ustawianych przez komponent kliencki, menu renderowanych dopiero po hydracji.
Mieszanka. Pogrupuj adresy URL według szablonu i sprawdź w każdej grupie odsetek stron, których treść jest w surowym HTML. Jedna grupa wyraźnie poniżej reszty to zwykle jeden szablon do poprawy. Testuj po każdym wydaniu: mała zmiana komponentu może przenieść tytuł lub link z serwera do przeglądarki.
Nie tylko Google: crawlery AI i surowy HTML
Asystenci AI pobierają strony, aby odpowiadać na pytania, a wiele ich crawlerów czyta HTML w takiej postaci, w jakiej przychodzi. Strona, która potrzebuje JavaScriptu do głównego tekstu, może być dla nich prawie pusta, nawet jeśli Google indeksuje ją bez problemu. SEO ProCheck opisuje SSR, CSR i widoczność w AI.
Crawl SEO witryny w JavaScripcie powinien więc pokazywać też, co dostaje każdy crawler AI. Poradnik o crawlerach AI omawia tokeny i reguły robots.txt.
Jak Neova crawluje witryny w JavaScripcie
Neova działa na Mac (Apple silicon), Windows i Linux, a Neova Online w przeglądarce. Renderowanie JavaScript jest w każdym planie, również w planie Free.
| Funkcja | Co robi |
|---|---|
| Renderowanie w Chrome | Wszystkie strony albo kilka z każdej grupy |
| Czekanie na renderowanie | Czeka, aż strona się ustabilizuje |
| Kolumna Renderowanie | Renderowana na serwerze, z hydracją, wymaga JavaScriptu |
| Źródło, surowe i wyrenderowane | Obie wersje HTML obok siebie |
| Ekran Renderowanie | Co dostaje każdy crawler AI |
| Plakietka Crawl bez renderowania | Pominięte testy, ponowny crawl jednym kliknięciem |
| Pobieraj przez Chrome | Dla witryn z ochroną przed botami |
Renderowanie jest domyślnie wyłączone, więc pierwszy crawl pozostaje szybki. Pobieraj przez Chrome jest w aplikacji desktopowej. Strona funkcji wymienia resztę, Porównanie pokazuje, jak renderowanie obsługują inne crawlery, a poradnik o zaawansowanym crawlerze SEO omawia renderowanie na dużą skalę.
Pytania
Czym jest crawler SEO do JavaScriptu?
To crawler, który wczytuje strony w prawdziwej przeglądarce, uruchamia ich skrypty i trzyma wyrenderowaną stronę obok surowego HTML wysłanego przez serwer. Porównanie obu pokazuje tytuły, linki, canonicale i tekst, które istnieją dopiero po uruchomieniu JavaScriptu.
Czy Google renderuje JavaScript?
Tak. Google crawluje URL, ustawia go w kolejce do renderowania w bezgłowym Chromium, a potem indeksuje wyrenderowaną stronę. Renderowanie może nastąpić później niż crawl, a wiele crawlerów AI czyta tylko surowy HTML.
Czym różni się surowy HTML od wyrenderowanego?
Surowy HTML to to, co wysyła serwer, zanim uruchomi się jakikolwiek skrypt. Wyrenderowany HTML to strona po wykonaniu JavaScriptu przez przeglądarkę. W witrynie renderowanej na serwerze są do siebie zbliżone; w aplikacji renderowanej po stronie klienta surowy HTML może być prawie pusty.
Czy muszę renderować każdą stronę witryny w JavaScripcie?
Zwykle nie. Najpierw wyrenderuj kilka stron z każdego szablonu. Szablony w całości obecne w HTML z serwera nie wymagają pełnego renderowania; szablony zależne od JavaScriptu tak.
Czy mogę za darmo przecrawlować witrynę w React lub Next.js?
Tak. Plan Free w Neova obejmuje renderowanie JavaScript w Chrome, do 1000 adresów URL w crawlu, ze wszystkimi testami. Zobacz cennik albo pobierz Neova.