Dokumentace

Kaloko

Stáhnout
Markdown s obrázky (.zip)Složka pro Docusaurus (.zip)Složka pro VitePress (.zip)Složka pro MkDocs (.zip)HTML pro offline čtení (.zip)PDFNovinky jako JSON
Stránky

Každý týden hlídat SEO a odpovědní vyhledávače

Ve čtvrtek vyjde nová verze překladů. V pondělí si někdo všimne, že polské produktové stránky přišly o strukturovaná data a polovina řeckého magazínu nemá meta popis. Týdenní průchod všech veřejných stránek by to řekl už v pátek ráno. Tahle stránka ho nastaví na příkladu Squared: www.squared.one ve 20 jazycích a www.vyvolej.to v češtině, slovenštině a ukrajinštině, zhruba 400 stránek na jazyk.

Plán:

  • jeden stack krok na každou obsahovou rodinu (e-shop, magazín, FAQ, ostatní), stránky z jazykových sitemap webu;
  • lanes podle obsahových rodin, takže plachta ukáže jeden řádek na rodinu;
  • sessions podle toho, čí pohled kontrolujete (návštěvník z vyhledávače, přihlášený člen klubu);
  • packy seo a aeo na každé stránce, jen jako rada, nikdy součást verdiktu;
  • workflow na GitHub Actions, který scénář projde každý týden a běh nasdílí;
  • výsledky přes API nebo MCP pro dashboard.

1. Najděte sitemapy

Nejrychleji to jde, když kroky 1 a 2 navrhne Kaloko podle webu samotného:

npx kaloko init --seo https://www.squared.one

Přečte robots.txt, jazyky vezme z adres sitemap (nebo z prvního úseku cest, když má web jednu sitemapu), z každého jazyka si projde vzorek stránek a zapíše qa/flows/seo-squared-one.yml: jeden rotující stack krok pro každou obsahovou rodinu s match pro každý jazyk, packy seo a aeo a produkční prostředí v novém kaloko.config.yml. Rodiny napříč jazyky páruje podle odkazů hreflang v sitemapách, potom podle stejného úseku a nakonec podle velikosti. Komentář na začátku souboru vypíše páry odhadnuté podle velikosti; ty před prvním průchodem zkontrolujte. --families 6 vezme víc rodin, --limit 100 víc stránek za týden, --packs seo,aeo,a11y přidá přístupnost. Když web není dostupný, nezapíše se nic. Zbytek stránky vysvětluje, co návrh obsahuje, abyste ho mohli doladit.

Squared uvádí v robots.txt jednu zabalenou (gzip) sitemapu na jazyk:

Sitemap: https://www.squared.one/sitemaps/en_US/sitemap.xml.gz
Sitemap: https://www.squared.one/sitemaps/de/sitemap.xml.gz
Sitemap: https://www.squared.one/sitemaps/es/sitemap.xml.gz
…

items: { robots: true } tyto řádky přečte. Když adresa sitemapy obsahuje procházený jazyk jako samostatný úsek (/sitemaps/de/…), čtou se jen sitemapy toho jazyka, takže německý průchod dostane německé stránky. en_US najde en_us i en-us; en si en-us nevezme. Web s jednou sitemapou pro všechny jazyky dostane celou a jazyk vybere match. Soubor můžete pojmenovat i sami: sitemap: '/sitemaps/{locale}/sitemap.xml.gz'. Zabalené sitemapy i indexy sitemap fungují v obou případech.

Poradí si i se stagingem za heslem. kaloko walk čte robots.txt a sitemapy s přístupem prostředí (jeho hlavičky, HTTP Basic, klientské certifikáty a cookies průchodu), a to jen na vlastních adresách prostředí. Sitemapu na jiném serveru, třeba na CDN, nebo takovou, která tam přesměruje, čte bez nich. Na jeden soubor má 60 sekund a 60 MB.

2. Rozdělte stránky na obsahové rodiny

Každá rodina je stack krok s vlastním match nebo exclude. Nejdřív se podívejte na první úsek cest v sitemapě každého jazyka: na Squared je přeložený i e-shop (/fi/tuotteet/, /pl/sklep/, /bg/foto-produkti/) a magazín je /de/zeitschrift/, /es/revista/, /fi/lehti/. Jeden regulární výraz se všemi překlady udrží jeden krok na rodinu pro všechny jazyky:

schema: qawalk.scenario.v1
id: SEO-weekly-squared
title: Weekly SEO and answer-engine monitor (squared.one)
kind: flow
locales: [en_US, de, es, fr, it, nl, pt]
viewports: { desktop: [1280, 800] }
environments: [production]
readonly: true
page: landing
health: { site: true }
lanes: [E-shop, Magazine, FAQ, Club and other pages]
sessions:
  visitor: { title: Visitor from search }
nodes:
  - id: eshop
    kind: stack
    title: E-shop
    lane: 0
    session: visitor
    packs: [seo, aeo, locale]
    items:
      robots: true
      match: '^/([a-z]{2}/)?(eshop|tuotteet|sklep|trgovina|katastima|pood|veikals|parduotuve|webshop|produse|foto-produkti)/'
      limit: 400
    fields:
      - { id: title, from: title }
      - { id: http, from: http }
      - { id: jsonld_types, label: Structured data }
      - { id: og_title, label: OG title, from: og:title }
      - { id: canonical, from: canonical }
    criteria:
      - { id: AC1, text: Product pages carry Product and BreadcrumbList data, check: { type: deterministic, assert: jsonld_present, types: [Product, BreadcrumbList] } }
  - id: magazine
    kind: stack
    title: Magazine
    lane: 1
    session: visitor
    packs: [seo, aeo, locale]
    items:
      robots: true
      match: '^/([a-z]{2}/)?(magazine|zeitschrift|revista|rivista|lehti|magazyn|revija|magazin|periodiko|ajakiri|zurnals|zurnalas|spisanie)/'
    fields: [{ id: title, from: title }, { id: words, from: words }, { id: jsonld_types }]
  - id: faq
    kind: stack
    title: FAQ
    lane: 2
    session: visitor
    packs: [seo, aeo, locale]
    items: { robots: true, match: '^/([a-z]{2}/)?faq/' }
    fields: [{ id: title, from: title }, { id: jsonld_types }]
  - id: pages
    kind: stack
    title: Club and other pages
    lane: 3
    session: visitor
    packs: [seo, aeo, locale]
    items: { robots: true, exclude: '/(eshop|tuotteet|sklep|trgovina|katastima|pood|veikals|parduotuve|webshop|produse|foto-produkti|magazine|zeitschrift|revista|rivista|lehti|magazyn|revija|magazin|periodiko|ajakiri|zurnals|zurnalas|spisanie|faq)(/|$)' }
    fields: [{ id: title, from: title }, { id: jsonld_types }]
edges: []

Zdroj s {locale} uvnitř { … } dejte do uvozovek, jinak YAML složené závorky přečte jako mapu.

Když je jeden výraz se všemi překlady příliš dlouhý, dejte match (nebo exclude) jeden výraz pro každý jazyk. Kaloko zkusí procházený jazyk, pak jeho základ (en pro en_US) a nakonec default:

    items:
      robots: true
      match:
        default: '^/([a-z]{2}/)?eshop/'
        fi: '^/fi/tuotteet/'
        pl: '^/pl/sklep/'
        bg: '^/bg/foto-produkti/'

Když mapa match procházený jazyk nemá a nemá ani default, průchod skončí chybou, aby zapomenutý jazyk nevzal všechny stránky webu. Mapa exclude bez jazyka nic nevyřadí.

match a exclude se vždy použijí před limit, u každého zdroje. Když stránky dodává váš skript (items: { script: steps/seo-items.mjs }), jeden skript obslouží všechny rodiny: dostane node (id, title, lane, lane_title, session) a items.params:

    items: { script: steps/seo-items.mjs, params: { family: magazine } }
// steps/seo-items.mjs
export default async ({ locale, node, params, url }) => {
  const res = await fetch(url(`/api/sitemap/${params.family}?locale=${locale}`))
  return (await res.json()).map((p) => ({ path: p.path, title: p.title }))
}

Před prvním celým průchodem si počty ověřte přes npx kaloko walk --limit 3 a podívejte se na čísla u kroků. Krok s 0 stránkami obvykle znamená, že v jeho výrazu chybí některý přeložený úsek.

Jedna stránka ve všech jazycích

Bez dalšího nastavení čte každý jazyk vlastní seznam, takže český produkt /eshop/obaly-na-fotky/ a jeho slovenský překlad /sk/eshop/obaly-na-fotky-nahodna-farba/ jsou ve stacku dvě různé stránky a každý jazyk vybere jiné produkty. Aby se překlady ukázaly jako jazykové verze jedné stránky, nechte stack vzít seznam v jednom jazyce a k ostatním dojít přes hreflang každé stránky:

    items:
      robots: true
      match: '^/eshop/'
      variants: hreflang
      source_locale: cs
      limit: 100
      rotate: week

Seznam, match, limit i rotate se berou ze source_locale (bez něj z prvního jazyka scénáře). V ostatních jazycích Kaloko každou vybranou stránku načte a projde adresu, kterou pro daný jazyk uvádí její <link rel="alternate" hreflang>, případně hlavička Link nebo xhtml:link v sitemapě, když stránka sama žádný nemá. Stránka si ponechá id zdrojové stránky, takže index stacku má pro každý produkt jeden řádek se snímkem v každém jazyce a všechny jazyky v daném týdnu kontrolují stejné produkty. Adresu, titulek a pole zdrojové stránky řádek ukáže, když běh prochází i zdrojový jazyk; běh jen s ostatními jazyky (--locales sk) ukáže, co našel první procházený jazyk.

Stránka, která v některém jazyce verzi nemá, tiše nezmizí. Index stacku u ní ten jazyk označí a HC1005 ji započítá: hreflang pro jazyk chybí, stránka uvádí jen x-default (to překlad není), hreflang pro jazyk vede zpátky na stránku samotnou, stránka nejde načíst, nebo překlad odpoví chybou (error 404). Započítají se i stránky, jejichž slovenský hreflang vede na stejnou adresu (obvykle výpis nebo úvodní stránku). kaloko export findings je vypíše jako řádky daného jazyka u zdrojové stránky, kam hreflang patří. Jestli překlad odkazuje zpátky, hlídá HC125 z packu seo.

Kaloko čte HTML tak, jak ho pošle server, bez spouštění skriptů, a s přístupem prostředí (jeho hlavičky a HTTP Basic, klientské certifikáty, cookies průchodu) jen na vlastních adresách prostředí. Když žádná alternativa neleží na doméně, ze které se stránka načetla, uvádí stránka adresy jiného webu: staging nebo náhled, jehož hreflang míří na produkci, i při jedné doméně pro každý jazyk. Kaloko pak otevře cestu každé alternativy na adrese procházeného jazyka z prostředí.

Když stránky po jazycích vypisuje váš skript, dejte každé stránce key, který je ve všech jazycích stejný (třeba cestu zdrojové stránky). Stránky se stejným key jsou ve stacku jedna stránka.

Hostované běhy (kaloko schedule add) seskupí jazykové verze stejně, se stejnými stránkami ve stejném týdnu. Přečtení zdrojové stránky kvůli hreflang se tam počítá jako stránka měsíčního limitu; víc v Hostovaných bězích.

3. Vyberte sessions

Session je jeden druh návštěvníka; každý krok nějakou uvádí. Pro hlídání veřejného SEO stačí jedna: visitor, nepřihlášený, tak jak web vidí vyhledávač. Když záleží i na stránkách po přihlášení (klubová sekce pro členy), přidejte session s account, její přihlášení jednou uložte přes npx kaloko auth save --env production --account member a těm krokům dejte session: member. Kroky po přihlášení držte mimo sitemapy: vyhledávače je nikdy neuvidí.

4. Co packy kontrolují

Pack seo kontroluje titulek, popis, canonical, hreflang, Open Graph, robots, H1 a viewport a nově i to, že stránka má JSON-LD (HC112) a že každý blok je platný JSON (HC113). Pack aeo přidává levné signály pro AI hledání a asistenty: FAQPage nebo QAPage tam, kde stránka klade otázky a odpovídá (HC901), krátký odstavec s odpovědí pod H1 (HC902), /llms.txt v kořeni webu, stažený jednou za průchod (HC903), meta popis (HC904) a stránku tak, jak ji bez JavaScriptu dostane GPTBot (HC905): jeden dotaz na stránku navíc, bez cookies a jen tam, kam GPTBota pustí robots.txt. Neprojde, když se titulek, canonical, H1, JSON-LD nebo většina textu objeví až po spuštění skriptů; když web nebo WAF GPTBota odmítne, ukáže se kontrola jako nehodnocená, ne jako chyba. Jiného crawlera zkontrolujete vlastním kritériem s assert: nojs_parity a user_agent: claudebot (nebo googlebot, perplexitybot, celý řetězec user agenta). Všechny kontroly jen radí. Pack errors k těmto krokům nedávejte: patří na chybové stránky a na běžných stránkách se jeho kontroly měkké 404 a vysvětlení chyby (HC601, HC605) nepoužijí. Když tým rozhodne, že produktové stránky musí mít strukturovaná data, převezměte kontrolu nebo napište vlastní kritérium jako AC1 výše. Podrobnosti jsou v Kritéria, kontroly a packy.

Co jedna stránka neukáže, vidí stack jako celek. Po průchodu porovná pack seo stránky téhož jazyka mezi sebou: stejné titulky, popisy a H1 (HC121–HC123), canonical, který míří jinam (HC124), hreflang, na který druhá jazyková verze neodpoví (HC125), a stránky ze sitemapy, které přesměrují, odpoví chybou nebo mají noindex (HC126). Nálezy mají počet stránek a v items.json i adresy, takže se dají předat k opravě po skupinách.

Pack locale hlídá jazykové verze: html lang, vlastní hreflang stránky, jazyk textu (nepřeložená stránka v jazykové verzi) a desetinný oddělovač cen (12,50 € v němčině, $12.50 v angličtině), vždy proti jazyku průchodu.

health: { site: true } přidá jednou za běh kontroly celého webu: robots.txt (překlepy, zablokované úvodní stránky, zablokovaní AI roboti), sitemapy z robots.txt (dostupné, platné, úplné adresy z vlastní domény, rozumné lastmod), /llms.txt a přesměrování http:// na https:// a druhé podoby domény (s www nebo bez) jedním skokem. Když web AI roboty blokuje schválně, nastavte health: { site: { ai_crawlers: false } }. V kaloko health mají kontroly celého webu vlastní řádek pro každý web.

5. Spočítejte velikost průchodu

Každá stránka trvá zhruba 1–2 sekundy a uloží asi čtyři soubory; sdílený běh pojme nejvýš 20 000 souborů. Squared má asi 400 stránek na jazyk, takže sedm jazyků (2 800 stránek, zhruba 11 000 souborů) se do jednoho běhu vejde. Jazyky rozdělte do scénářů se stejnými kroky:

SouborJazyky
qa/flows/seo-squared-west.ymlen_US, de, es, fr, it, nl, pt
qa/flows/seo-squared-north-east.ymlda, sv, fi, pl, sl, hr, el
qa/flows/seo-squared-baltic-south.ymlet, lv, lt, hu, ro, bg
qa/flows/seo-vyvolej.ymlcs, sk, uk (prostředí s base_url: https://www.vyvolej.to)

walk.concurrency v kaloko.config.yml prochází několik jazyků najednou; se 3 nebo 4 se týdenní běh o pár tisících stránkách vejde do hodiny až dvou.

Velký katalog po částech

Když mají všechny jazyky dohromady víc stránek, než se vejde do jednoho běhu, projděte každý týden jen část každé rodiny. rotate: week vezme limit stránek a každý ISO týden začne jinde, takže celý seznam projde za počet stránek ÷ limit týdnů:

    items: { robots: true, match: '^/([a-z]{2}/)?eshop/', limit: 100, rotate: week }

Se 400 produktovými stránkami na jazyk projde e-shop celý jednou za čtyři týdny za čtvrtinovou cenu. Průchod vypíše, kterou část bere (rotating sample, week 2026-W41 — pages 101…200 of 400, all covered in 4 weeks). Stejný týden dá stejné stránky, takže běh zopakovaný v úterý zkontroluje totéž co pondělní.

rotate: run počítá běhy místo týdnů. Počet a čas poslední kontroly každé stránky Kaloko drží v .cache/stack/ výstupní složky (tmp/kaloko), takže funguje tam, kde složka mezi běhy zůstává (váš počítač, vlastní runner). Čistý checkout na GitHub Actions začíná pokaždé od nuly: tam použijte rotate: week.

steps/<krok>/items.json v běhu pak má pro každý jazyk sekci rotation (okno, kolik stránek už prošlo kontrolou a kolik ještě nikdy) a každá stránka svůj last_checked: kdy ji Kaloko zkontroloval naposledy předtím, nebo null.

Ať se velký běh vejde

Sdílený běh pojme 300 MB v uložené podobě. HTML a JSON se posílají zabalené gzipem, takže snímky stránek zaberou zhruba desetinu své velikosti na disku; nejvíc přidávají screenshoty. Stránky stacku se fotí celé, takže typická dlouhá stránka uloží screenshot kolem 600 kB a náhled kolem 180 kB (náhled je stejně vysoký jako stránka). Běh se tak zaplní zhruba při 400 stránkách.

Rodina stránek pro SEO potřebuje stránku, ne její obrázek. capture: { screenshot: thumb, full_page: false } ponechá jen náhled první obrazovky široký 640 px, asi 25 kB, podle kterého stránku ve stacku poznáte:

    items: { robots: true, match: '^/([a-z]{2}/)?eshop/', limit: 100, rotate: week }
    capture: { screenshot: thumb, full_page: false }

Samotné capture: { full_page: false } uloží ostrou první obrazovku (asi 70 kB), samotné capture: { screenshot: thumb } náhled celé stránky. Výchozí nastavení nechte u rodin, kde někdo prochází celou stránku nebo kde sémantická kontrola čte, co je pod první obrazovkou.

Když se běh blíží limitu, kaloko share vypíše největší kroky, ať víte, kterou rodinu zkrátit, a upozorní, když většinu místa zabírá stack focený celý.

6. Procházejte ho každý týden na GitHub Actions

npx kaloko schedule export github --scenario qa/flows/seo-squared-west.yml --env production --every week --at 5

Příkaz zapíše workflow, který scénář projde v pondělí v 5:00 UTC, vyhodnotí ho a běh nasdílí. Potřebuje secret KALOKO_TOKEN (role Tester, rozsah upload). Pro každý scénář vyexportujte jeden workflow, každý v jinou hodinu, a u velkých zvyšte ve workflow timeout-minutes. Když konfigurace říká, že každý scénář uvádí vlastní projekt (komentář, nebo produkt s projects:), dejte scénáři project: seo nebo jiný z nich; kaloko validate na chybějící projekt upozorní a sdílení bez něj může skončit chybou HTTP 404.

Bez GitHub Actions projde stejný scénář na straně Kaloka kaloko schedule add (plán Business). Stacky čte ze sitemap a z robots.txt, bere base_url pro každý jazyk a bez screenshotů rozhodne kontroly, kterým stačí prvky stránky; každá stránka stacku se počítá do měsíčního rozpočtu hostovaných stránek. Strukturovaná data, kontroly pro odpovědní vyhledávače a jazyka tam zůstanou „nevyhodnoceno“, takže pro plné packy SEO a AEO patří dál plné CLI na GitHub Actions. Víc v návodu Kontrolovat stránky podle plánu.

7. Výsledky do dashboardu

Každý sdílený běh má svou kondici: nálezy podle závažnosti, packu a kroku a co přibylo nebo se spravilo od minulého týdne. Pro dashboard:

  • GET /api/v1/orgs/<org>/scenarios/<id>/latest/health/aggregate?by=locale,step,check sečte nejnovější běh po jazycích, obsahových rodinách a kontrolách, s nejvíc zasaženými stránkami a s tím, kolik výsledků je od minulého týdne nových nebo opravených. …/latest/health/diff je vypíše stránku po stránce, každou s týdnem, kdy poprvé selhala. Token s rozsahem read:health čte tohle a nic dalšího, což se hodí pro dashboard, který si data stáhne jednou týdně. Tvar odpovědí je v API kondice pro dashboardy; MCP má get_health_aggregate a get_health_diff.
  • Webhook health.changed dá po každém běhu vědět, když je něco nového nebo opraveného.
  • GET /api/v1/orgs/<org>/health?project=<projekt> nebo MCP get_health { project } vrátí vývoj projektu; get_health { scenario } nejnovější běh jednoho scénáře.
  • MCP get_stack_items { run_id, step, status?, criterion?, query? } vypíše stránky jednoho kroku s jejich poli (jsonld_types, og_title), stavem a nesplněnými kontrolami, třeba každou stránku e-shopu, které chybí HC112.
  • Ve složce běhu má steps/<krok>/items.json totéž po stránkách a jeho structured_data sčítá stránky podle typu schema.org, stránky bez strukturovaných dat a stránky s neplatným JSON-LD. kaloko health --json vypíše nálezy lokálního běhu.

Obvykle stačí týdenní graf „stránky bez strukturovaných dat“ a „nové chyby kondice“ po obsahových rodinách. Když číslo poskočí, otevřete běh na plachtě a stack vyfiltrujte podle neúspěšné kontroly.

8. Předejte opravy tomu, kdo je udělá

Najít chybu je půlka práce; redaktor pak ještě musí najít stránku v CMS. Dejte každé stránce cestu zpátky:

  • skript se stránkami vrátí vedle path i edit_url (stránka v CMS) a content_ref (záznam, pod kterým ji zná obsahové API);
  • nebo stack dostane resolver, který je dohledá pro stránky procházené tento týden:
    items: { robots: true, match: '^/([a-z]{2}/)?eshop/', limit: 100, rotate: week, resolve: steps/resolve.mjs }
// steps/resolve.mjs
export default async (item, { locale }) => {
  const res = await fetch(`https://cms.example.com/api/pages?path=${encodeURIComponent(item.path)}&locale=${locale}`)
  const page = res.ok ? await res.json() : null
  return page ? { edit_url: `https://cms.example.com/pages/${page.id}/edit`, content_ref: `page:${page.id}` } : {}
}

Stránka, u které resolver selže nebo do 15 sekund neodpoví, se projde i tak, jen bez odkazu, a průchod řekne, kolik jich bylo. Detail stránky na plachtě pak ukáže Upravit v CMS a CSV stacku má oba sloupce. Celý seznam:

npx kaloko export findings --format csv --out opravy.csv
npx kaloko export findings --format json --locale de --step eshop

Každý řádek je jedna nesplněná kontrola na jedné stránce v jednom jazyce: URL, kontrola, důkaz, edit_url, content_ref a příkaz, který stránku projde znovu (kaloko walk --steps eshop --items <stránka> --locales de). JSON jde rovnou agentovi s obsahovým API, u Squared nástrojům MCP, které změnu navrhnou, provedou a ověří. Po opravě stačí ten jeden příkaz a stránka se zkontroluje znovu bez procházení zbytku, i když rotující stack mezitím přešel na jiné stránky; takový průchod se do rotace nepočítá.

Pracujte s nálezy, ne se stránkami

Dvě stě produktových stránek bez strukturovaných dat v polštině je jeden problém v šabloně produktu, ne dvě stě. Kondice → Nálezy u scénáře (odkaz u každého scénáře na stránce kondice) seskupí, co je otevřené, podle kontroly, webu, jazyka a kroku: jeden řádek na problém, se závažností, počtem zasažených stránek, několika z nich s odkazem upravit a týdnem, kdy se objevil poprvé. Nález potvrďte, když na něm někdo pracuje, nebo ho ignorujte a napište proč („starý blog, v listopadu se stěhuje do nového CMS“). Rozhodnutí u nálezu zůstává týden po týdnu a nález je opravený, jakmile žádná jeho stránka neselhává. Dashboard nebo agent čte totéž přes GET …/scenarios/<id>/findings nebo MCP list_findings.

Když tým pracuje v Jiře, Linearu, GitHub Issues nebo Plane, může Developer / Tester nechat scénář zakládat jedno issue na každý nový nález od zvolené závažnosti (PUT …/scenarios/<id>/findings/sync { "tracker": "jira", "min_severity": "error" }). Kaloko pak issue okomentuje, když se počet stránek hodně změní, a zavře ho, když je nález opravený. Práci rozdělí cesty (routes): technické kontroly (canonical, hreflang, strukturovaná data) do repozitáře vývojářů na GitHubu, obsahové (popisky, tenký obsah, nízká míra prokliku) do projektu marketingu v Plane. S daty o návštěvnosti (oddíl 9) issue řekne, kolik kliknutí a zobrazení stránky mají. Podrobnosti jsou v API kondice pro dashboardy.

9. Opravte nejdřív stránky, které lidé opravdu vidí

Dvě stě chybějících popisů je dlouhý seznam. Search Console ví, které z těch stránek lidé ve vyhledávání vidí, a Kaloko to umí využít. Vyexportujte ze Search Console tabulku Stránky (Výkon, Stránky, Exportovat, CSV), uložte ji vedle scénáře a uveďte ji:

traffic:
  file: traffic/search-console-stranky.csv

Export stárne, takže až týdenní běh poběží, nechte ho ptát se Search Console přímo. V Google Cloud založte servisní účet, jeho e-mail přidejte do vlastnosti jako uživatele, cestu k jeho JSON klíči dejte do GOOGLE_APPLICATION_CREDENTIALS (v GitHub Actions jako secret repozitáře) a soubor nahraďte vlastností:

traffic:
  gsc: { property: sc-domain:example.com }

Každý běh si pak jednou řekne o kliknutí, zobrazení, CTR a pozici všech stránek za posledních 28 dní. ga4: { property: "123456789" } stejně přidá relace a klíčové události podle vstupních stránek.

Co se změní:

  • kaloko export findings dá nahoru nálezy na nejvíc zobrazovaných stránkách a ke každému řádku přidá clicks, impressions, ctr, position, sessions a impact, takže obsahový tým začne odshora;
  • index stránek na plachtě má sloupce Zobrazení a Kliknutí; kliknutím podle nich seřadíte;
  • pack seo přidá ke každému stacku HC127: stránky, které se ve vyhledávání ukazují často, ale klikne se na ně ani ne napůl tak často jako na stránky webu na podobných pozicích. Obvykle za to můžou titulek a popis ve výsledcích.

Vzorec a všechny klíče najdete v Konfiguračním souboru. Data z jiných SEO nástrojů (klíčová slova, viditelnost v AI) Kaloko zatím nepřipojuje.

Na této stránceNa této stránce