Jak jste se mohli na českém internetu dočíst, Seznam přišel v dubnu 2017 s novinkou v podobě Seznam Webmaster. Tuto platformu či chcete-li rozhraní lze přirovnat k tomu co nabízí Google Search Console. Hlavními funkcemi je momentálně poskytnuní informací, které má Seznam uložené v indexu o vaší stránce. Jak Seznam uvádí nástroj slouží hlavně pro komunikaci se správci webů. Nejvíce informací lze z nástroje momentálně získat pomocí jeho API. Tomu se na zoubek podívali naši programátoři a zde přinášíme výsledek i s návodem.
Přenos dat ze Seznam Webmaster API do Google Docs
AKTUALIZACE 10.11.2019: Skript byl aktualizován, při požádání o aktuální výpis URL se nově vytváří nový list s časovou značkou pro pozdější detailní analýzy změn v indexovaných URL, šablona byla upravena, byl přidán graf vývoje indexu, byly upraveny některé překlepy. Zároveň se při požadavku na detail URL přidávají do seznamu adres místo toho aby se přepisovali.
AKTUALIZACE 14.4.2019: Skript byl aktualizován, obsahuje nyní i ošetření pro případ, že některý z dotazů vrátí počet URL 0. Plus byly přidány drobné komentáře do textu a šablona dokumentu pro snadnější kopírování.
Aktuální odkaz na šablonu: Google Sheets Seznam Webmaster API šablona
Aktuální odkaz na kód: https://github.com/marekcech/seznam-webmaster
Proč?
Počítám, že odborníci na SEO jistě mají jasno, co jim údaje o stránkách zařazených v indexu, případně o stránkách s chybou můžou poskytnout. Pro nás je ještě zajímavé, že pokud data dostaneme do Google Docs / Google Sheets můžeme je krásně využít v Google Data Studiu. Zde už pak začíná to, co máme na naší práci nejradši a to servírování klíčových údajů klientům ve stravitelné formě a ve správném okamžiku.
Jak bude vypadat výstup?
Výstupem jsou seznamy odkazů v Google Sheets tabulce. Viz snímek ukazující jeden z výstupů pro tento web.
Co budete potřebovat?
- Google účet s přístupem do Google Docs
- Přístup do Seznam Webmaster
- Ověřenou doménu v Seznam Webmaster (min 1 den předem, chvílí trvá než se data publikují)
- Čas, cca 30 minut, záleží na zručnosti
Postup přidání webu do Seznam Webmaster
1. Otevřete si adresu Seznam Webmaster – https://reporter.seznam.cz/wm/web/prehled
2. V roletce vlevo dejte Přidat nový web, web autorizujte buď přidáním meta značky či pomocí txt souboru
3. Nezapomeňte přidat jak zabezpečenou tak nezabezpečenou verzi, verzi s www a bez www nepřidávejte!
4. Následně si v API – Klíč k API připravte váš API klíč, pokud jste web ověřili až nyní, bude trvat až 24 hodin než se data do API propíší
Postup přenosu dat ze Seznam Webmaster API do Google Docs
1. Vytvořte tabulku s názvem např. doména.cz seznam webmaster – pokud budete chtít pracovat s indexem pro zabezpečenou i nezabezpečenou verzi stránky je nutné vytvořit dva dokumenty. Případně si můžete zkopírovat tuto šablonu Google Docs Seznam Webmaster API šablona, která v sobě již skript obsahuje
2. Připravte si strukturu tabulky, potřebujete 6 listů pro správnou funkčnost celého skritu včetně správného pojmenování
Vytvořte první list s názvem Index History, ten bude obsahovat celou historii dostupnou přes API pro váš web. V listu si následně připravte strukturu viz snímek obrazovky. Zde si také můžete kontrolovat zda jednotlivé další dotazy vrací správné hodnoty (zda sedí počet URL).
Druhý list s názvem Error Urls bude obsahovat adresy, u kterých Seznam Bot našel chybu. Momentálně nelze ale zjistit typ chyb. Struktura opět viz snímek obrazovky.
Třetí list s názvem Index Urls bude obsahovat adresy, které jsou u Seznamu indexované. Struktura opět viz snímek obrazovky.
Čtvrtý list s názvem Content Urls bude obsahovat adresy, které Seznam bot navštívil. Struktura opět viz snímek obrazovky.
Pátý list s názvem Redirect Urls bude obsahovat adresy, které Seznam bot navštívil a našel u nich přesměrování. Struktura opět viz snímek obrazovky.
Šestý s názvem Url Details bude obsahovat detaily o konkrétní stránce, pokud si je vyžádáte (viz dále). Struktura opět viz snímek obrazovky.
3. Vytvořte přidružený script k dokumentu. V panelu nabídek zvolte Nástroje – Editor skritů (Tools – Script editor). Vytvořte nový projekt s názvem např. seznam webmaster. V projektu vytvořte nový soubor s názvem seznam.gs a do něj použijte kód, který můžete nalézt zde.
Následně soubor uložte, budete dotázáni na povolení přístupu k vašemu Google účtu. Bez povolení přístupu, bohužel nemůžete pokračovat. Povolení se vztahuje na přístup k dokumentům a externímu API endpointu.
4. V kódu upravte v úvodu proměnou API_KEY, do které dáte vám přidružený API klíč pro konkrétní web. Viz Seznam Webmaster.
5. Následně stačí script znovu uložit a aktualizovat otevřenou tabulku.
6. Po aktualizaci otevřené tabulky byste měli v panelu nabídek vidět položku Seznam Webmaster.
Content Urls byly přejmenovány na Download Urls pro snadnější identifikaci.
V této rozbalovací nabídce naleznete vše, co k obsloužení skriptu potřebujete. Níže je vysvětlení položek.
History Data – načte historický vývoj webu v indexu do listu Index History
Error Urls, Download Urls, Index Urls, Redirect Urls – načtou příslušené odkazy do nových listů s časovou značku dle šablony
Reindex Selected – kdekoliv v dokumentu označte v buňce odkaz, u kterého chcete požádat o reindexaci, funguje i pro výběr více odkazů v souvislém výběru, po provedení scriptu se v sloupci reindexace objeví hláška
Details about Selected – kdekoliv v dokumentu označte v buňce odkaz, u kterého chcete získat detaily, do listu Url Details se vypíší detaily o stránce, které má Seznam uložené, jde především o titulek, popis, klíčová slova, odkaz a og:graph údaje
Poznámka: U těchto dvou posledních hromadných dotazů pozor na limity API, které jsou v době psaní článku:
- nejvýše 5 dotazů za vteřinu
- nejvýše 100 dotazů za minutu
- požadavek na vynucení indexace stránek je možno dělat nejvýše 500 krát za den
- na jednotlivé dotazy API vrátí max 1000 URLs
7. Upravte script dle vašech potřeb. Je jasné, že script je velmi jednoduchý, ale má potenciál na další rozšíření. Pro nás je klíčové, že tato data již snadno použijeme v Google Data Studiu v reportech pro naše klienty či SEO specialisty, kteří s nimi dále pracují.
Možná rozšíření, které třeba časem přidáme, jsou například:
– automaticky vytvářené listy dle data dotazu (hotovo)
– optimalizace scriptu
– nastavení API limitů apod.
Changelog
0.1 – 8.11.2017
- první verze
0.2 – 14.4.2019
- přidáno ošetření, když API vrátí 0 URLs
- úprava článku
- šablona dokumentu
0.3 – 10.11.2019
- překlepy opraveny
- generování listů s časovou značkou
- přidán graf
- úprava šablony
Dotazy či vaše úpravy scriptu můžete zanechat v komentářích.
