Konfiguracja Search Insights krok po kroku
Ten poradnik prowadzi przez całą konfigurację Search Insights w Baza Helper. Potrzebujesz uprawnień administratora witryny WordPress oraz dostępu do konta Google, które jest właścicielem usługi w Search Console. Ustawienia znajdziesz w Baza Helper > Search Insights > Settings.
Krok 1: Utwórz konto usługi w Google Cloud
- Otwórz Google Cloud Console i utwórz projekt lub wybierz istniejący.
- Otwórz APIs and services i włącz Google Search Console API dla projektu.
- Przejdź do IAM and admin > Service accounts i utwórz konto usługi. Wystarczy nazwa taka jak baza-helper. Nie musisz przypisywać mu ról w Google Cloud.
- Otwórz konto usługi, przejdź do Keys, wybierz Add key > Create new key, wskaż JSON i pobierz plik. Nie udostępniaj go osobom postronnym.
Krok 2: Przyznaj kontu usługi dostęp do Search Console
- Skopiuj adres e-mail konta usługi. Kończy się on na iam.gserviceaccount.com.
- Otwórz Google Search Console i wybierz usługę.
- Przejdź do Settings > Users and permissions i naciśnij Add user.
- Wklej adres e-mail i wybierz Restricted, czyli dostęp tylko do odczytu. Pełny dostęp nie jest potrzebny, ponieważ Search Insights jedynie odczytuje dane.
Krok 3: Wybierz sposób przechowywania klucza
W zakładce Settings wybierz Service account (recommended), a następnie jeden z trzech sposobów przechowywania klucza:
- Przesłanie lub wklejenie klucza. Naciśnij Choose the key file (.json) lub przeciągnij pobrany plik JSON do pola. Plik jest odczytywany w przeglądarce i zapisywany w postaci zaszyfrowanej po naciśnięciu Save changes. Pod polem możesz też wkleić treść klucza.
- Plik na serwerze poza publicznym katalogiem witryny. Podaj jego ścieżkę w ustawieniach.
- Stała w wp-config.php: BAZA_HELPER_GSC_KEY_FILE określa ścieżkę do pliku, BAZA_HELPER_GSC_KEY_JSON zawiera sam klucz, a BAZA_HELPER_GSC_PROPERTY wskazuje usługę. W tym wariancie klucz nie trafia do bazy danych.
Krok 4: Wybierz usługę
Wpisz usługę dokładnie tak, jak jest zapisana w Search Console. Usługa domenowa ma postać sc-domain:example.com. Usługę z prefiksem URL podaje się jako pełny adres, na przykład https://example.com/. Naciśnij Load my properties, aby wybrać ją z listy usług dostępnych dla konta.
Krok 5: Sprawdź połączenie
Naciśnij Test the connection. Test wykonuje kolejne kontrole i wyjaśnia, na którym etapie wystąpił błąd oraz dlaczego. Usuń wskazaną przyczynę i uruchom test ponownie.
Alternatywa: Google OAuth
- W Google Cloud utwórz klienta OAuth typu Web application.
- Dodaj adres przekierowania widoczny w zakładce Settings modułu Search Insights do listy dozwolonych identyfikatorów URI przekierowania.
- Wpisz Client ID i Client secret w ustawieniach, a następnie naciśnij Connect with Google.
- Na ekranie zgody Google zezwól na odczyt danych. Witryna przechowuje tylko zaszyfrowany refresh token.
Krok 6. Ustaw codzienne pobieranie danych
- Daily copy: włączenie lub wyłączenie codziennego pobierania oraz godzina według czasu witryny.
- Days for the first fill: od 7 do 485 dni. Po pierwszym połączeniu dane z wybranego okresu są pobierane małymi partiami.
- Days to keep: od 30 do 485 dni. Starsze wiersze są usuwane.
- Row limit per day i pomijanie wierszy z niewielką liczbą wyświetleń pomagają ograniczyć rozmiar tabeli.
- Search type: web, image, video, news, Discover lub Google News.
- Final or fresh data: dane ostateczne są kompletne, ale dostępne z około dwudniowym opóźnieniem; świeże pojawiają się wcześniej, lecz mogą się jeszcze zmienić.
- Naciśnij Sync now, aby od razu rozpocząć pobieranie. Pasek postępu pokaże jego stan.
Krok 7. Przyznaj dostęp asystentowi
- Otwórz zakładkę Assistant i włącz REST, MCP lub oba warianty.
- Wybierz, kto może odczytywać dane przy użyciu hasła: tylko administratorzy czy redaktorzy i administratorzy.
- Naciśnij New token, nadaj nazwę i określ ważność: bezterminowo, 30 dni, 90 dni lub 1 rok. Od razu skopiuj token, ponieważ witryna przechowuje tylko jego skrót.
- Ustaw limit żądań na minutę dla tokena.
Podłączanie asystenta
- Claude Code: dodaj serwer MCP poleceniem pokazanym w zakładce Assistant, na przykład claude mcp add z adresem MCP i tokenem w nagłówku Authorization.
- Cursor: wklej blok mcp.json z zakładki Assistant do ustawień MCP.
- Dowolny czat wysyłający żądania internetowe: skopiuj instrukcję z zakładki Assistant. Zawiera już adres i trasy API.
- Konektory internetowe ChatGPT i claude.ai wymagają OAuth, który nie jest jeszcze obsługiwany dla tego połączenia.
Krok 8. Skonfiguruj IndexNow
- Otwórz zakładkę Indexing i znajdź kartę IndexNow.
- Sprawdź klucz. Wtyczka sama udostępnia plik klucza, a test potwierdza jego dostępność.
- Wyślij listę adresów ręcznie lub włącz automatyczne wysyłanie po opublikowaniu, aktualizacji albo usunięciu wpisu.
- Wybierz wyszukiwarki. IndexNow działa z Bing i innymi wyszukiwarkami obsługującymi ten protokół. Google nie obsługuje IndexNow.
- Sprawdź dziennik, aby zobaczyć wysłane adresy i odpowiedzi wyszukiwarek.
Typowe błędy i ich przyczyny
- 403, no permission: konto usługi nie zostało dodane do usługi Search Console lub nie ma do niej dostępu. Sprawdź krok 2.
- Property not found: nazwa usługi nie zgadza się z Search Console. Usługa domenowa wymaga prefiksu sc-domain:, a usługa z prefiksem URL dokładnego adresu z ukośnikiem. Sprawdź krok 4.
- API not enabled: Google Search Console API nie jest włączone w projekcie Google Cloud. Sprawdź krok 1.
- URL Inspection limit: Google pozwala na około 2000 kontroli URL Inspection na usługę dziennie. Poczekaj do następnego dnia lub sprawdzaj mniej stron.
- No data yet: pierwsze pobieranie nadal trwa albo Google nie opublikował jeszcze danych z ostatnich dni. Zwykle pojawiają się one po dwóch lub trzech dniach.
Zakładki i ustawienia
Search Insights ma siedem zakładek: Overview, Pages, Queries, Opportunities, Indexing, Assistant i Settings. Przycisk Scan all pages of the site znajduje się w Indexing. Zapisz klucz i pozostałe ustawienia przyciskiem Save changes na dole strony.
Plik klucza możesz wybrać lub przeciągnąć w obu wariantach przechowywania: w zaszyfrowanej postaci w bazie danych albo w chronionym folderze baza-helper-private na serwerze.
