Nastavenie Search Insights krok za krokom
Tento návod vás prevedie celým nastavením Search Insights v Baza Helper. Potrebujete prístup správcu k webu WordPress a prístup k účtu Google, ktorý je v Search Console vedený ako vlastník webu. Nastavenia nájdete v Baza Helper > Search Insights > Settings.
Krok 1: Vytvorte účet služby v Google Cloud
- Otvorte Google Cloud Console a vytvorte projekt alebo vyberte existujúci.
- Otvorte APIs and services a zapnite Google Search Console API pre projekt.
- Prejdite do IAM and admin > Service accounts a vytvorte účet služby. Stačí názov ako baza-helper. Nemusíte mu prideľovať roly v Google Cloud.
- Otvorte účet služby, prejdite do Keys, vyberte Add key > Create new key, zvoľte JSON a stiahnite súbor. Neposkytujte ho nepovolaným osobám.
Krok 2: Udeľte účtu služby prístup do Search Console
- Skopírujte e-mailovú adresu účtu služby. Končí sa na iam.gserviceaccount.com.
- Otvorte Google Search Console a vyberte vlastníctvo.
- Prejdite do Settings > Users and permissions a stlačte Add user.
- Vložte e-mail a vyberte Restricted, teda prístup iba na čítanie. Plný prístup nie je potrebný, pretože Search Insights údaje iba číta.
Krok 3: Vyberte spôsob uloženia kľúča
Na karte Settings vyberte Service account (recommended) a potom jeden z troch spôsobov uloženia kľúča:
- Nahratie alebo vloženie kľúča. Stlačte Choose the key file (.json) alebo presuňte stiahnutý súbor JSON do poľa. Súbor sa načíta v prehliadači a po stlačení Save changes sa uloží zašifrovaný. Pod poľom môžete vložiť aj text kľúča.
- Súbor na serveri mimo verejne dostupného priečinka webu. Jeho cestu zadajte v nastaveniach.
- Konštanta vo wp-config.php: BAZA_HELPER_GSC_KEY_FILE pre cestu k súboru, BAZA_HELPER_GSC_KEY_JSON pre samotný kľúč a BAZA_HELPER_GSC_PROPERTY pre vlastníctvo. Pri tejto možnosti sa kľúč nedostane do databázy.
Krok 4: Vyberte vlastníctvo
Zadajte vlastníctvo presne tak, ako je uvedené v Search Console. Doménové vlastníctvo má tvar sc-domain:example.com. Vlastníctvo s predponou adresy URL sa zadáva ako úplná adresa, napríklad https://example.com/. Stlačte Load my properties a vyberte ho zo zoznamu dostupného účtu.
Krok 5: Otestujte pripojenie
Stlačte Test the connection. Test vykoná kontroly postupne a zrozumiteľne vysvetlí, v ktorom kroku nastala chyba a prečo. Odstráňte uvedenú príčinu a test zopakujte.
Alternatíva: Google OAuth
- V Google Cloud vytvorte klienta OAuth typu Web application.
- Pridajte adresu presmerovania uvedenú na karte Settings v Search Insights do zoznamu povolených identifikátorov URI presmerovania.
- Zadajte Client ID a Client secret v nastaveniach a stlačte Connect with Google.
- Na obrazovke súhlasu Google povoľte čítanie údajov. Web uchováva iba zašifrovaný refresh token.
Krok 6. Nastavte každodenné sťahovanie údajov
- Daily copy: zapnutie alebo vypnutie denného sťahovania a výber hodiny podľa času webu.
- Days for the first fill: od 7 do 485 dní. Po prvom pripojení sa údaje za vybrané obdobie sťahujú po menších častiach.
- Days to keep: od 30 do 485 dní. Staršie riadky sa odstránia.
- Row limit per day a vynechávanie riadkov s nízkym počtom zobrazení pomáhajú obmedziť veľkosť tabuľky.
- Search type: web, image, video, news, Discover alebo Google News.
- Final or fresh data: konečné údaje sú úplné, ale prichádzajú približne s dvojdňovým oneskorením; čerstvé údaje sú novšie, no ešte sa môžu meniť.
- Stlačte Sync now a spustite sťahovanie ihneď. Ukazovateľ priebehu zobrazí jeho stav.
Krok 7. Udeľte prístup asistentovi
- Otvorte kartu Assistant a zapnite REST, MCP alebo obe možnosti.
- Vyberte, kto môže čítať údaje pomocou hesla: iba správcovia alebo editori a správcovia.
- Stlačte New token, zadajte názov a platnosť: bez obmedzenia, 30 dní, 90 dní alebo 1 rok. Token hneď skopírujte, pretože web uchováva iba jeho hash.
- Nastavte povolený počet požiadaviek za minútu pre token.
Pripojenie asistenta
- Claude Code: pridajte server MCP príkazom z karty Assistant, napríklad claude mcp add s adresou MCP a tokenom v hlavičke Authorization.
- Cursor: vložte blok mcp.json z karty Assistant do nastavení MCP.
- Akýkoľvek chat, ktorý vie posielať webové požiadavky: skopírujte pokyny z karty Assistant. Adresa aj trasy API sú už vyplnené.
- Webové konektory ChatGPT a claude.ai vyžadujú OAuth, ktorý pre toto pripojenie zatiaľ nie je podporovaný.
Krok 8. Nastavte IndexNow
- Otvorte kartu Indexing a nájdite kartu IndexNow.
- Skontrolujte kľúč. Plugin sám sprístupňuje súbor kľúča a kontrola overí, či je dostupný.
- Odošlite zoznam adries ručne alebo zapnite automatické odosielanie pri publikovaní, aktualizácii či odstránení príspevku.
- Vyberte vyhľadávače. IndexNow funguje s Bingom a ďalšími vyhľadávačmi, ktoré tento protokol podporujú. Google IndexNow nepodporuje.
- V denníku skontrolujte, ktoré adresy sa odoslali a či vyhľadávač odpovedal.
Bežné chyby a ich príčiny
- 403, no permission: účet služby nie je pridaný k vlastníctvu alebo k nemu nemá prístup. Skontrolujte krok 2.
- Property not found: názov vlastníctva sa nezhoduje so Search Console. Doménové vlastníctvo potrebuje predponu sc-domain: a vlastníctvo s predponou URL presnú adresu s lomkou. Skontrolujte krok 4.
- API not enabled: Google Search Console API nie je zapnuté v projekte Google Cloud. Skontrolujte krok 1.
- URL Inspection limit: Google povoľuje približne 2000 kontrol URL Inspection na vlastníctvo za deň. Počkajte do ďalšieho dňa alebo kontrolujte menej stránok.
- No data yet: prvé sťahovanie ešte prebieha alebo Google zatiaľ nezverejnil údaje za posledné dni. Zvyčajne sa objavia s oneskorením dva až tri dni.
Karty a nastavenia
Search Insights má sedem kariet: Overview, Pages, Queries, Opportunities, Indexing, Assistant a Settings. Tlačidlo Scan all pages of the site je na karte Indexing. Kľúč a ostatné nastavenia uložte tlačidlom Save changes v spodnej časti stránky.
Súbor kľúča môžete vybrať alebo presunúť pri oboch možnostiach uloženia: zašifrovaný v databáze alebo v chránenom priečinku baza-helper-private na serveri.
