Dokumentacja

Jak działa IndexFast

Kompletny przewodnik po konfiguracji i korzystaniu z IndexFast, od uzyskania klucza API po automatyczne codzienne indeksowanie.

⚡ Szybki start

Aby rozpocząć korzystanie z IndexFast, musisz wykonać 3 kroki. Cały proces trwa około 10-15 minut.

✅Wymagania

Zanim zaczniesz, upewnij się, że masz:

☁️ Ustawienia Google Cloud

Włączenie API

Przejdź do konsoli Google Cloud → Interfejsy API i usługi → Biblioteka. Znajdź to „API indeksowania wyszukiwania internetowego” i naciśnij Włączać.

Tworzenie konta usługi

Konto usługi to konto techniczne niewymagające hasła, którego IndexFast używa do autoryzacji interfejsów API Google. Aby go utworzyć, potrzebujesz projektu w Google Cloud.

{
  typ: „konto_usługi”,
  „id_projektu”: „identyfikator-twojego projektu”,
  „id_klucza_prywatnego”: „abc123…”,
  „klucz_prywatny”: "-----ROZPOCZNIJ KLUCZ PRYWATNY RSA-----\n...",
  „e-mail_klienta”: "[e-mail chroniony]",
  „id_klienta”: „123456789”,
  "auth_uri": „https://accounts.google.com/o/oauth2/auth”,
  „token_uri”: „https://oauth2.googleapis.com/token”
}

🔗 Połączenie z Search Console

Bez tego kroku interfejs API zwróci błąd 403 Zabronione nawet z właściwym kluczem. Konto Usługi musi otrzymać status właściciela witryny w Google Search Console.

🗺 Mapa witryny.xml

IndexFast odczytuje Twoje mapa witryny.xml aby uzyskać adresy URL do przesłania do indeksowania. Obsługiwane są wszystkie formaty.

Obsługiwane formaty

• ✅ mapa witryny.xml — standardowy plik z adresem URL
• ✅ sitemap_index.xml — plik nadrzędny z linkami do mapy witryny podrzędnej (dowolna głębokość zagnieżdżenia)
• ✅ Mapa witryny z tagami — filtrowanie według daty aktualizacji

Gdzie znaleźć adres URL mapy witryny

⚙️Jak działa usługa

IndexFast automatycznie odczytuje Twoje mapa witryny.xml i wysyła adres URL za pośrednictwem interfejsu Google Indexing API. Nie trzeba instalować żadnego skryptu - wszystkie operacje wykonywane są na serwerach IndexFast.

🤖 Automatyczny harmonogram

IndexFast rozpoczyna indeksowanie automatycznie — nie ma potrzeby konfigurowania cron ani utrzymywania serwera. Usługa działa całodobowo po stronie IndexFast.

Jak zarządzać indeksowaniem

🖱 Ręczne indeksowanie

Oprócz trybu automatycznego IndexFast umożliwia w każdej chwili rozpoczęcie indeksowania ręcznego – bezpośrednio z konta osobistego.

📊 Limity API

Google zapewnia bezpłatny limit y 200 adresów URL dziennie na konto usługi. IndexFast automatycznie monitoruje limit i zatrzymuje się po jego osiągnięciu.

🔧 Integracje z platformami

WordPressa

Jeśli używasz Yoast SEO Lub Ranking matematyki — mapa witryny jest już gotowa:

Potrzebujesz pomocy w integracji? Zastosuj do wsparcie.

Shopify

Shopify automatycznie generuje mapę witryny pod adresem /sitemap.xml. Obejmuje strony, produkty, kolekcje i wpisy na blogu.

Potrzebujesz pomocy w integracji? Zastosuj do wsparcie.

Laravel

Polecamy pakiet do generowania mapy witryny w Laravel spatie/Laravel-Sitemap:

kompozytor wymaga mapy witryny spatie/Laravel

używać Spatie\Sitemap\SitemapGenerator;

SitemapGenerator::create(„https://twoja-witryna.com”)
    ->zapisz do pliku (ścieżka_publiczna („mapa witryny.xml”));

Potrzebujesz pomocy w integracji? Zastosuj do wsparcie.

Inne platformy

Potrzebujesz pomocy w integracji? Zastosuj do wsparcie.

📡 Dokumentacja API

Upoważnienie

Używa Google Indexing API OAuth 2.0 za pośrednictwem konta usługi. IndexFast obsługuje autoryzację automatycznie – potrzebujesz jedynie klucza JSON.

Punkt końcowy, który ma otrzymać token:

POST https://oauth2.googleapis.com/token

Typ zawartości: application/x-www-form-urlencoded

typ_grantu=urn:ietf:params:oauth:grant-type:jwt-bearer
&twierdzenie={JWT_TOKEN}

Przesyłanie adresów URL do indeksowania

POST https://indexing.googleapis.com/v3/urlNotifications:publikuj

Autoryzacja: na okaziciela {ACCESS_TOKEN}
Content-Type: application/json

{
  „adres URL”: „https://twoja-witryna.com/nowa-strona”,
  typ: „URL_AKTUALIZACJA”
}

Pomyślna odpowiedź:

{
  „urlNotificationMetadata”: {
    „adres URL”: „https://twoja-witryna.com/nowa-strona”,
    „najnowsza aktualizacja”: {
      „adres URL”: „https://twoja-witryna.com/nowa-strona”,
      typ: „URL_AKTUALIZACJA”,
      „powiadomCzas”: „2026-01-20T10:30:00Z”
    }
  }
}

Kontrola stanu adresu URL

DOSTAWAĆ https://indexing.googleapis.com/v3/urlNotifications/metadata
    ?url=https://twoja-witryna.com/strona

Autoryzacja: na okaziciela {ACCESS_TOKEN}

Kody błędów

❓ Często zadawane pytania

Jak długo trwa indeksowanie po przesłaniu?

Google zazwyczaj przetwarza żądania w ramach 24–48 godzin. W większości przypadków strony pojawiają się w wyszukiwaniu już następnego ranka po wysłaniu.

Czy można przesłać więcej niż 200 adresów URL dziennie?

200 adresów URL to standardowy bezpłatny limit Google. W razie potrzeby możesz złożyć wniosek o zwiększenie limitu poprzez Google Cloud Console. IndexFast automatycznie zatrzymuje się po osiągnięciu limitu i wznawia następnego dnia.

Czy korzystanie z interfejsu Indexing API jest bezpieczne dla SEO?

Tak, to prawda urzędnik metoda zalecana przez samo Google. Brak ryzyka kary lub obniżenia ratingu – wręcz przeciwnie, szybsza indeksacja poprawia konkurencyjność.

Indeks map witryn czy zwykła mapa witryny?

IndexFast obsługuje oba typy. Jeśli przekażesz link do sitemap_index.xml — skrypt automatycznie ominie wszystkie załączone pliki i zapisze wszystkie adresy URL.

📋 Lista zmian

wersja 2.4 — czerwiec 2026 r

— Integracja z IndexNow: automatyczne przesyłanie adresu URL do Bing, Naver, Seznam.cz i Yep.
— Uruchomiony program partnerski (Program partnerski).
— Dodano interaktywny kalkulator ROI do strony głównej.

wersja 2.3 — marzec 2026 r

— Autoryzacja przez Google (OAuth): zaloguj się jednym kliknięciem bez haseł.
- Wielojęzyczność: Dodano obsługę 8 nowych języków.
— Taryfa została uruchomiona Agencja z obsługą do 50 witryn i raportami typu White-label.

wersja 2.2 — styczeń 2026 r

— Obsługa indeksu map witryn (automatyczne przeglądanie załączonych plików o dowolnej głębokości).
— Publiczny interfejs API REST dla programistów.
— Poprawione rejestrowanie i wyświetlanie statusów 200/403 w czasie rzeczywistym.

wersja 2.0 – grudzień 2024

— Uruchomienie platformy chmurowej SaaS (wcześniej usługa działała jako skrypt lokalny).
— Automatyczny harmonogram dzienny z zarządzaniem limitami.

wersja 1.0 – wrzesień 2024

— Pierwsze uruchomienie usługi.
— Podstawowe przesyłanie adresu URL za pośrednictwem interfejsu API Google Indexing.

💬 Wsparcie

Jeśli masz jakieś pytania lub problemy, jesteśmy gotowi pomóc: