seomaestro

Poradniki · Technika

JavaScript a boty AI: sprawdź, co widzą na twojej stronie

JavaScript a boty AI: jak Google renderuje strony, czemu inne boty mogą widzieć tylko surowy HTML, jak to sprawdzić w 10 minut i co przenieść do HTML.

Redakcja SEO Maestro10.11.20268 min czytaniaźródła sprawdzone 10.11.2026

Otwierasz swoją stronę w przeglądarce i widzisz opis usług, cennik i opinie klientów. Bot, który pobiera ten sam adres, może dostać pusty szkielet z jednym <div id="app"> i paczką skryptów. Google potrafi taki szkielet wyrenderować, ale sam przyznaje, że nie wszystkie boty uruchamiają JavaScript. Najprościej założyć, że boty AI czytają tylko HTML z odpowiedzi serwera. Ten poradnik pokazuje, jak sprawdzić, co w nim jest, i co przenieść tam w pierwszej kolejności.

Jak Google radzi sobie z JavaScriptem

Google opisuje swój proces w dokumencie Understand the JavaScript SEO basics. Strona przechodzi przez trzy fazy: pobranie (crawling), renderowanie i indeksowanie.

Najpierw Googlebot pobiera adres zwykłym żądaniem HTTP i czyta odpowiedź serwera. Wyciąga z niej linki z atrybutu href i dopisuje je do kolejki. Potem każda strona ze statusem 200 trafia do kolejki renderowania, czyli do poczekalni przed przeglądarką bez okna. Google pisze, że strona może tam czekać kilka sekund, ale też dłużej. Gdy ma wolne zasoby, uruchamia przeglądarkę headless Chromium w aktualnej wersji, wykonuje skrypty i dopiero z wyrenderowanego HTML-a buduje indeks.

Najważniejsze zdanie tego dokumentu dotyczy jednak nie Google'a. Renderowanie po stronie serwera albo prerendering to według Google'a „wciąż świetny pomysł”, bo strona działa szybciej dla ludzi i robotów, a nie wszystkie boty potrafią uruchomić JavaScript.

Google nazywa też problem po imieniu. Część stron korzysta z modelu „app shell”: pierwszy HTML nie zawiera właściwej treści, a ta pojawia się dopiero po wykonaniu skryptów. Działa to jak katalog sklepu, do którego ktoś wkleja zdjęcia produktów już po wydrukowaniu. Kto dostał wersję z drukarni, zobaczy puste ramki.

Co wiadomo o botach OpenAI i Perplexity

Dokumentacja OpenAI o botach wymienia kilka agentów:

  • OAI-SearchBot służy do pokazywania stron w wynikach wyszukiwania ChatGPT. Strony, które go zablokują, nie pojawią się w odpowiedziach ChatGPT search, choć mogą się pokazać jako linki nawigacyjne.
  • GPTBot zbiera treści, które mogą trafić do trenowania modeli. Blokada oznacza, że nie chcesz ich do tego używać.
  • ChatGPT-User odwiedza stronę, gdy użytkownik zada pytanie w ChatGPT albo Custom GPT. Nie przeszukuje sieci automatycznie, a reguły robots.txt mogą go nie obejmować.

Dokumentacja Perplexity opisuje dwa boty. PerplexityBot pokazuje i linkuje strony w wynikach Perplexity i według firmy nie zbiera treści do trenowania modeli. Perplexity-User odwiedza strony na prośbę użytkownika i zazwyczaj ignoruje robots.txt.

W żadnej z tych dokumentacji nie ma słowa o renderowaniu JavaScriptu. Nie wiesz więc, czy te boty wykonują skrypty, a jeśli tak, to czy zawsze i jak długo czekają na treść. Nie piszę, że na pewno ich nie wykonują, bo źródła tego nie mówią. Skoro jednak nawet Google, który renderuje, ostrzega przed innymi botami, rozsądnie projektować stronę pod najsłabszego czytelnika. Jeśli treść jest w surowym HTML-u, przeczyta ją każdy bot, który dostanie się do strony. Jeśli jest tylko w skryptach, liczysz na to, że bot je wykona.

Jest też drugi warunek: bot musi w ogóle dostać odpowiedź. Perplexity wprost pisze, że zapora aplikacyjna (WAF) może blokować jej boty, i pokazuje reguły dla Cloudflare i AWS WAF. Sam robots.txt opisuje poradnik ClaudeBot, GPTBot, PerplexityBot: które boty AI wpuścić.

Sprawdź stronę bez JavaScriptu: 10 minut, dziś

Wybierz trzy adresy: stronę główną, najważniejszą stronę usługi albo produktu i jeden artykuł. Na każdym zrób to samo.

  1. Otwórz źródło strony. W Chrome wpisz przed adresem view-source:, na przykład view-source:https://przyklad.pl/uslugi. To jest HTML z serwera, a nie widok po wykonaniu skryptów. Szukaj (Ctrl+F) zdania z pierwszego akapitu, nazwy usługi, ceny, numeru telefonu. Jeśli ich nie ma, bot bez JavaScriptu też ich nie zobaczy.
  2. Wyłącz JavaScript w przeglądarce. W narzędziach deweloperskich Chrome (F12) otwórz menu poleceń (Ctrl+Shift+P), wpisz „Disable JavaScript” i odśwież stronę. Zobaczysz mniej więcej to, co dostaje bot bez renderowania. Biały ekran albo sam napis „Loading…” to app shell.
  3. Pobierz stronę z wiersza poleceń jako bot. Wpisz w terminalu:
curl -s -A "Mozilla/5.0 (compatible; PerplexityBot/1.0; +https://perplexity.ai/perplexitybot)" https://przyklad.pl/uslugi | grep -i "Pracownia Kowalski"

Zamiast nazwy firmy wstaw dowolne zdanie z treści. Pusty wynik oznacza brak tego tekstu w HTML-u. Komenda pokaże też, czy serwer w ogóle odpowiada: strona z wyzwaniem zapory zamiast treści to sygnał, żeby sprawdzić WAF. Pamiętaj, że to tylko symulacja. Prawdziwe boty przychodzą z opublikowanych adresów IP, więc twoja zapora może je traktować inaczej niż twój komputer.

  1. Porównaj z widokiem Google'a. W Search Console użyj narzędzia do sprawdzania adresu URL albo testu wyników z elementami rozszerzonymi i obejrzyj wyrenderowany HTML. Google sam to zaleca, żeby sprawdzić, czy treść jest widoczna po renderowaniu. Jeśli Google ma treść, a curl nie, problem dotyczy właśnie botów, które nie renderują.
  2. Zapisz różnice w tabelce: adres, czego brakuje w surowym HTML-u, kto to naprawi. To lista zadań dla programisty albo agencji.

Co przenieść do HTML-a w pierwszej kolejności

Nie musisz przepisywać całej aplikacji. Zacznij od elementów, z których asystent AI buduje odpowiedź o twojej firmie.

ElementDlaczego w HTML-uUwagi z dokumentacji Google
Główna treść strony (opis usługi, artykuł)Bez niej bot nie ma czego cytowaćTreść widoczna dopiero po renderowaniu Google zindeksuje, inne boty niekoniecznie
<title> i meta descriptionOpisują stronę jednym zdaniemJavaScript może je ustawić, ale HTML jest pewniejszy
Link kanonicznyWskazuje właściwy adresGoogle zaleca HTML; skrypt nie powinien zmieniać wartości z HTML-a
Linki nawigacyjneBot po nich trafia na kolejne stronyTylko elementy <a> z href, bez adresów z #/
Dane strukturalne JSON-LDOpisują firmę wprostGoogle przyjmuje JSON-LD wstrzyknięty skryptem, ale to Google
Meta robotsDecyduje o indeksowaniunoindex w HTML-u może sprawić, że Google w ogóle nie wyrenderuje strony

Kilka z tych punktów wymaga wyjaśnienia.

Linki. Google wykrywa linki tylko wtedy, gdy są elementami <a> z atrybutem href. Nawigacja na fragmentach (#/uslugi) jest według Google złą praktyką, bo Googlebot nie potrafi takich adresów pewnie odczytać. W aplikacjach jednostronicowych Google zaleca History API i zwykłe ścieżki:

<nav>
  <ul>
    <li><a href="/uslugi">Usługi</a></li>
    <li><a href="/cennik">Cennik</a></li>
    <li><a href="/kontakt">Kontakt</a></li>
  </ul>
</nav>

Dane strukturalne. Google akceptuje JSON-LD generowany skryptem. To nie znaczy, że zobaczy go każdy bot. Jeśli opis firmy ma być czytelny dla wszystkich, wpisz go w szablon strony na serwerze:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Pracownia Kowalski",
  "url": "https://przyklad.pl",
  "logo": "https://przyklad.pl/logo.png"
}
</script>

Szerzej o tych typach piszę w poradniku Dane strukturalne pod AI: Organization i Article.

Komponenty i shadow DOM. Google spłaszcza shadow DOM przy renderowaniu i widzi tylko to, co trafiło do wyrenderowanego HTML-a. Bot bez renderowania nie zobaczy nawet tego. Treść zamknięta w komponencie webowym, który buduje się dopiero w przeglądarce, to przy botach AI ryzyko.

Strony błędów. W aplikacjach z routingiem po stronie klienta łatwo o „miękkie 404”, czyli stronę błędu ze statusem 200. Google radzi przekierować skryptem na adres, dla którego serwer zwraca 404, albo dodać noindex. Prościej i pewniej jest jednak zwracać właściwy kod z serwera.

Wybierz sposób naprawy

Są trzy drogi, różnią się kosztem.

  1. Renderowanie po stronie serwera (SSR). Serwer od razu wysyła gotowy HTML z treścią, a JavaScript potem tylko ożywia interfejs. Większość popularnych frameworków ma taki tryb. To rozwiązanie, które Google wymienia jako pierwsze.
  2. Prerendering. Strony generuje się z wyprzedzeniem do statycznych plików HTML. Dobrze działa przy treściach, które rzadko się zmieniają: opisach usług, artykułach, stronie „o nas”.
  3. Hybryda. Najważniejsze sekcje (nagłówek, opis, cennik, kontakt) idą w HTML-u, a interaktywne dodatki, takie jak kalkulator, filtry czy czat, zostają w skryptach. Jeśli zespół nie ma czasu na przebudowę, to najszybszy kompromis.

Nie przenoś do HTML-a wszystkiego na siłę. Filtr produktów czy formularz z walidacją mogą zostać w JavaScripcie. Liczy się to, żeby zdania, które mają opisać twoją firmę w odpowiedzi AI, były w pierwszym HTML-u. Jak takie zdania pisać, opisuje poradnik Treść cytowana przez AI: struktura strony krok po kroku.

Uczciwie trzeba dodać jedno: przeniesienie treści do HTML-a usuwa przeszkodę techniczną, ale nie gwarantuje cytowań. Bot zobaczy tekst, a o tym, czy go użyje, decyduje już jakość i trafność treści.

Upewnij się, że bot w ogóle dochodzi do HTML-a

Najlepiej wyrenderowany HTML nic nie da, jeśli zapora odeśle bota z wyzwaniem. Perplexity zaleca w regułach WAF łączyć sprawdzanie User-Agenta z opublikowanymi zakresami IP, bo sam nagłówek łatwo podrobić. Dla Cloudflare reguła ma akcję „Skip” i musi stać nad regułami blokującymi. Firma zastrzega też, że Bot Fight Mode w Cloudflare nie da się w ten sposób pominąć, więc przy włączonym trybie jej boty wciąż mogą dostawać wyzwanie. Zakresy adresów publikują w plikach JSON, a OpenAI robi to samo dla OAI-SearchBot, GPTBot i ChatGPT-User.

OpenAI dodaje, że po zmianie robots.txt jego systemy potrzebują około 24 godzin, żeby uwzględnić nowe reguły w wynikach wyszukiwania. Po poprawkach nie sprawdzaj więc efektu po godzinie. Daj botom kilka dni i zajrzyj do logów serwera, czy żądania z OAI-SearchBot i PerplexityBot dostają status 200 i pełny HTML.

Dopiero gdy obie rzeczy są załatwione, czyli bot dochodzi do strony, a treść leży w HTML-u, ma sens mierzenie, czy asystenci AI cię cytują. Jak to robić bez zgadywania, opisuje poradnik Widoczność w AI: jak zmierzyć widoczność marki.

Źródła

Gdy już wiesz, co widzą boty, sprawdź, czy ChatGPT, Gemini, Perplexity, Claude i Grok cytują twoją stronę w odpowiedziach na pytania z twojej branży. Wynik dostaniesz po około 90 sekundach w darmowym teście SEO Maestro.