Poradniki · Technika
IndexNow: jak wdrożyć szybkie zgłaszanie zmian na stronie
IndexNow krok po kroku: plik z kluczem, przykładowe żądanie GET i POST, wyszukiwarki obsługujące protokół według FAQ oraz kody błędów i ich przyczyny.
Redakcja SEO Maestro05.11.20268 min czytaniaźródła sprawdzone 05.11.2026
Zmieniasz cenę w sklepie, usuwasz wyprzedany produkt albo publikujesz nowy wpis i czekasz, aż robot wyszukiwarki sam to zauważy. Według FAQ IndexNow takie czekanie potrafi trwać dni, a nawet tygodnie. IndexNow pozwala wysłać wyszukiwarkom adres zmienionej strony w chwili zmiany: jedno żądanie HTTP z adresem i kluczem, który potwierdza, że strona jest twoja. Poniżej opisuję, jak przygotować klucz, jak wygląda żądanie, które wyszukiwarki je przyjmują i na czym najczęściej kończy się pierwsze wdrożenie.
Jak działa protokół IndexNow
IndexNow to umówiony sposób powiadamiania wyszukiwarek. Robot przestaje zgadywać, co się zmieniło, bo sam mu to mówisz. Działa to jak kartka na drzwiach sklepu: zamiast czekać, aż klienci przyjdą i zobaczą nowy towar, wysyłasz im wiadomość.
Mechanizm składa się z trzech elementów:
- klucz, czyli ciąg znaków, który wymyślasz sam,
- plik z kluczem umieszczony na twojej domenie, dzięki któremu wyszukiwarka sprawdza, że zgłoszenie pochodzi od właściciela,
- żądanie HTTP z adresem strony (albo listą adresów) i kluczem.
Dokumentacja na indexnow.org zawiera jeszcze jedną zasadę: wyszukiwarki uczestniczące w protokole zobowiązują się automatycznie przekazywać sobie nawzajem zgłoszone adresy. Wysyłasz więc żądanie do jednej z nich, a pozostałe też je dostają.
Kod 200 w odpowiedzi oznacza tylko tyle, że wyszukiwarka przyjęła adres. FAQ mówi wprost, że zgłoszenie nie gwarantuje natychmiastowej indeksacji. Wyszukiwarka sama ocenia, czy i kiedy odwiedzić stronę, na podstawie limitu crawlowania, harmonogramu i sygnałów jakości. Każdy zgłoszony adres liczy się do tego limitu, ale jest traktowany priorytetowo w porównaniu z adresami niezgłoszonymi.
Które wyszukiwarki obsługują IndexNow według FAQ
FAQ IndexNow wymienia punkty końcowe (endpointy), czyli adresy, pod które wysyłasz zgłoszenie. Wybierasz jeden z nich:
| Wyszukiwarka | Endpoint |
|---|---|
| Globalny endpoint IndexNow | https://api.indexnow.org/indexnow |
| Amazon | https://indexnow.amazonbot.amazon/indexnow |
| Bing | https://www.bing.com/indexnow |
| Naver | https://searchadvisor.naver.com/indexnow |
| Seznam.cz | https://search.seznam.cz/indexnow |
| Yandex | https://yandex.com/indexnow |
| Yep | https://indexnow.yep.com/indexnow |
Google nie występuje na tej liście. IndexNow nie zastępuje więc mapy witryny ani zwykłego SEO pod Google. FAQ wspomina natomiast, że szybsze indeksowanie pomaga utrzymać aktualne treści w wynikach wyszukiwania opartych na AI. Ma to znaczenie, jeśli zależy ci na widoczności w asystentach AI, o czym piszę szerzej w poradniku GEO SEO. Związku między IndexNow a cytowaniem przez konkretnego asystenta nikt jednak nie gwarantuje. To tylko szybsza droga do indeksu, nic ponadto.
Sprawdź, czy nie masz już IndexNow
Zanim zaczniesz generować klucze, zajrzyj do swojego systemu. FAQ wymienia CMS-y, które obsługują IndexNow natywnie albo przez wtyczki: WordPress, Shopify, Wix, GoDaddy, Duda, XenForo, Milestone, Joomla!, Drupal, Bitrix24, PrestaShop, MODX, Shopware, OpenCart, Typo3 i Umbraco. Z sieci CDN natywną integrację ma Cloudflare.
Strona Bing Webmaster Tools o IndexNow podaje konkretne wtyczki. Dla WordPressa są to wtyczka IndexNow, Yoast, RankMath, AIOSEO i SEOPress, a dla Shopify InstaIndex. W Cloudflare włączasz funkcję Crawler Hints. Bing radzi też zalogować się do Bing Webmaster Tools i sprawdzić, czy strona już wysyła adresy, bo IndexNow mogło zostać włączone razem z wtyczką SEO, której używasz od lat.
Jeśli integracja działa, plik z kluczem i żądania obsługuje za ciebie system. Ręczne wdrożenie zostaje dla stron pisanych od zera, nietypowych CMS-ów i sytuacji, w których chcesz kontrolować, co i kiedy zgłaszasz.
Wdróż IndexNow ręcznie krok po kroku
Pierwsze zgłoszenie możesz wysłać jeszcze dziś. Potrzebujesz dostępu do serwera (FTP albo panel hostingu) i terminala z curl.
- Wygeneruj klucz. Wystarczy generator GUID/UUID albo narzędzie wiersza poleceń. Klucz musi mieć od 8 do 128 znaków i może zawierać tylko małe litery (a-z), wielkie litery (A-Z), cyfry (0-9) i myślniki. W systemie z
uuidgenjedno polecenie daje gotowy klucz.
- Utwórz plik z kluczem. W edytorze tekstu wklej sam klucz, bez spacji i bez dodatkowych linii. Zapisz plik w kodowaniu UTF-8, a jako nazwę daj klucz z rozszerzeniem
.txt. Dla kluczaa1b2c3d4e5f6a7b8plik nazywa sięa1b2c3d4e5f6a7b8.txti zawiera wyłączniea1b2c3d4e5f6a7b8.
- Wgraj plik do katalogu głównego domeny. Dla strony Pracowni Kowalski będzie to:
https://www.przyklad.pl/a1b2c3d4e5f6a7b8.txt
- Otwórz ten adres w przeglądarce. Jeśli widzisz tylko klucz, bez logowania i bez przekierowania na stronę główną, weryfikacja ma szansę się udać.
- Wyślij pierwsze zgłoszenie jednego adresu. Adres strony w parametrze
urlmusi być zakodowany zgodnie z RFC-3986::zamieniasz na%3A,/na%2F,?na%3F,=na%3D,&na%26.
curl "https://api.indexnow.org/indexnow?url=https%3A%2F%2Fwww.przyklad.pl%2Foferta%2Fstoly-debowe&key=a1b2c3d4e5f6a7b8"
- Sprawdź kod odpowiedzi. Przy pierwszym żądaniu możesz dostać 202: adres przyjęto, a klucz czeka na weryfikację. Kolejne poprawne zgłoszenia zwykle zwracają 200.
- Zweryfikuj odbiór w Bing Webmaster Tools. Bing wskazuje swój panel jako miejsce, w którym sprawdzisz, czy zgłoszone adresy dotarły.
Gdy masz kilka albo kilkaset zmienionych stron, wysyłasz je jednym żądaniem POST z JSON-em. Limit to 10 000 adresów na żądanie.
POST /indexnow HTTP/1.1
Host: api.indexnow.org
Content-Type: application/json; charset=utf-8
{
"host": "www.przyklad.pl",
"key": "a1b2c3d4e5f6a7b8",
"urlList": [
"https://www.przyklad.pl/oferta/stoly-debowe",
"https://www.przyklad.pl/oferta/krzesla",
"https://www.przyklad.pl/blog/jak-pielegnowac-drewno"
]
}
W curl to samo wygląda tak:
curl -X POST "https://api.indexnow.org/indexnow" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{"host":"www.przyklad.pl","key":"a1b2c3d4e5f6a7b8","urlList":["https://www.przyklad.pl/oferta/stoly-debowe","https://www.przyklad.pl/oferta/krzesla"]}'
Jeśli plik z kluczem nie może leżeć w katalogu głównym, dokumentacja dopuszcza drugą opcję: plik w innym miejscu tej samej domeny i parametr keyLocation w każdym zgłoszeniu. Wtedy położenie pliku ogranicza zakres adresów. Plik w /katalog/ uprawnia tylko do zgłaszania adresów zaczynających się od /katalog/, a adresy spoza tego folderu mogą zostać pominięte przy indeksowaniu. Dokumentacja zdecydowanie zaleca katalog główny, więc trzymaj się go, jeśli tylko możesz.
{
"host": "www.przyklad.pl",
"key": "a1b2c3d4e5f6a7b8",
"keyLocation": "https://www.przyklad.pl/oferta/a1b2c3d4e5f6a7b8.txt",
"urlList": [
"https://www.przyklad.pl/oferta/stoly-debowe"
]
}
Ręczne wysyłanie wystarczy na test. Na co dzień dokumentacja zaleca automat, który wysyła zgłoszenie w momencie dodania, aktualizacji albo usunięcia treści.
Zgłaszaj zmiany, nie całą stronę
Według FAQ IndexNow służy do zgłaszania tego, co się właśnie zmieniło. Dobre okazje do zgłoszenia to:
- nowe treści: produkty, wpisy, oferty pracy, wydarzenia,
- aktualizacje: opisy produktów, strony firmowe, regulaminy,
- zmiany ceny i dostępności, promocje, wygasłe oferty,
- usunięte i przekierowane strony. FAQ wprost zaleca zgłaszać adresy z przekierowaniem 301, 302 lub meta refresh oraz strony zwracające 404 albo 410, żeby wyszukiwarka usunęła je z indeksu,
- treści użytkowników, takie jak opinie czy komentarze, ale stopniowo. FAQ podaje przykład: zgłaszaj każdą opinię od 1. do 20., potem co piątą do setnej, potem co dziesiątą do tysięcznej.
Czego nie zgłaszać? Kosmetycznych zmian układu strony i tego samego adresu wiele razy dziennie bez realnej zmiany treści. Przy często aktualizowanych stronach FAQ zaleca odczekać co najmniej 5 minut przed ponownym zgłoszeniem. Nie wysyłaj też wstecz zmian sprzed wdrożenia. Do tego służy mapa witryny z poprawnymi wartościami lastmod. Wyjątkiem jest migracja albo przebudowa serwisu: wtedy FAQ dopuszcza jednorazowe zgłoszenie wszystkich adresów.
IndexNow i mapa witryny nie konkurują ze sobą. Mapa daje wyszukiwarce pełny spis stron, także tych rzadko zmienianych i głęboko ukrytych, a IndexNow zgłasza świeże zmiany. FAQ zaleca używać obu.
Typowe błędy i kody odpowiedzi
Większość problemów z IndexNow widać od razu w kodzie odpowiedzi. Oto znaczenie kodów według dokumentacji i najczęstsze przyczyny:
- 202 Accepted. Adres przyjęty, klucz czeka na weryfikację. To normalne przy pierwszym zgłoszeniu i nie wymaga poprawek.
- 400 Bad request. Nieprawidłowy format żądania. Zwykle chodzi o literówkę w JSON-ie, brak nagłówka
Content-Type: application/json; charset=utf-8albo niezakodowany adres w parametrzeurl. - 403 Forbidden. Klucz nieważny: wyszukiwarka nie znalazła pliku albo plik istnieje, ale nie zawiera klucza. Sprawdź, czy plik nie wymaga logowania, czy jego nazwa zgadza się co do znaku z kluczem, czy nie ma w nim dodatkowych spacji i czy zapisałeś go w UTF-8.
- 422 Unprocessable Entity. Adresy nie należą do domeny podanej w
hostalbo klucz nie pasuje do schematu protokołu. Typowa wpadka to zgłaszanie adresów zprzyklad.plprzy"host": "www.przyklad.pl". Ten sam kod może się pojawić po przekroczeniu limitu 10 000 adresów w jednym żądaniu. - 429 Too Many Requests. Za dużo żądań, wyszukiwarka podejrzewa spam. Ogranicz częstotliwość i nie powtarzaj tego samego adresu bez zmiany treści.
Do tego dochodzą błędy, których kod nie pokaże:
- Oczekiwanie gwarancji. Kod 200 oznacza odbiór, nie indeksację. Bing w swoim FAQ pisze, że zmiana może pojawić się w wynikach dopiero po czasie.
- Klucz na widoku. Dokumentacja mówi, że klucz i położenie pliku powinny znać tylko ty i wyszukiwarki. Nie wklejaj go do publicznego repozytorium ani do kodu strony widocznego dla użytkowników.
- Zmiana klucza bez podmiany pliku. Jeśli zmieniasz klucz, zastąp stary plik nowym i zacznij wysyłać zgłoszenia z nowym kluczem. Wyszukiwarka sama zweryfikuje go przy następnym zgłoszeniu.
- Podwójna integracja. Wtyczka SEO i własny skrypt wysyłające te same adresy marnują limit crawlowania. Wybierz jedno.
Dobrze wdrożone IndexNow widać po jednym: zmieniasz cenę stołu dębowego o dziesiątej, a o dziesiątej zero jeden Bing ma już ten adres w kolejce.
Źródła
- IndexNow - Documentation - format żądań GET i POST, zasady klucza i pliku, opcja keyLocation, kody odpowiedzi i wymóg dzielenia się adresami między wyszukiwarkami.
- IndexNow - FAQ - lista endpointów i wyszukiwarek, obsługujące CMS-y i Cloudflare, kodowanie adresów, limity, zasady zgłaszania zmian i współpraca z mapą witryny.
- Bing Webmaster Tools - How to add IndexNow to your website - wtyczki dla WordPressa i Shopify, Crawler Hints w Cloudflare oraz weryfikacja zgłoszeń w panelu Bing.
Jeśli chcesz sprawdzić, czy asystenci AI w ogóle cytują twoją stronę jako źródło, zrób to w darmowym teście SEO Maestro. Wynik dostaniesz po około półtorej minuty, bez zakładania konta.
Czytaj dalej
Jak działa wyszukiwarka Google: skanowanie, indeksowanie i AI
Jak działa wyszukiwarka Google: trzy etapy z dokumentacji, miejsce AI Overviews i AI Mode, czego Google nie gwarantuje i co sprawdzić na swojej stronie.
22.11.2026 · 8 minAdres kanoniczny (canonical): jedna wersja strony dla Google i AI
Adres kanoniczny krok po kroku: rel=canonical, przekierowania, sygnały Google, zasady RFC 6596 i typowe błędy w sklepach i na blogach.
21.11.2026 · 8 minRSS a boty AI: kanał RSS i Atom, który czytają wyszukiwarki
RSS a boty AI: jak zbudować poprawny kanał RSS 2.0 lub Atom, zgłosić go Google jako sitemap i powiadamiać o zmianach przez WebSub. Z przykładami kodu.