Koqivo - local-first crawler SEO i panel analityczny
Koqivo to desktopowa aplikacja local-first do technicznego audytu SEO. Łączy crawler stron, analizę indeksowalności, sitemap, robots.txt, danych strukturalnych, linkowania wewnętrznego, Lighthouse oraz integracje z Google Search Console, GA4 i Merchant Center.
Problem do rozwiązania
Celem projektu było stworzenie narzędzia, które pozwala analizować techniczne problemy SEO bez uzależniania głównego procesu crawlowania od zewnętrznej infrastruktury. Kluczowym wyzwaniem było połączenie lokalnego crawlera, dużej liczby danych diagnostycznych, dynamicznego renderowania stron JavaScriptem, reguł SEO oraz danych z ekosystemu Google w jednym spójnym interfejsie. Rozwiązanie musiało zachować kontrolę nad danymi lokalnie, a jednocześnie obsługiwać zewnętrzne integracje OAuth i wysoką złożoność widoków analitycznych.
Koqivo zostało zaprojektowane jako lokalna aplikacja desktopowa dla technicznych audytów SEO. Rdzeniem systemu jest crawler obsługujący klasyczne pobieranie HTML oraz renderowanie stron dynamicznych przez Playwright. Dane są zapisywane lokalnie w SQLite, co pozwala analizować większe zbiory URL-i bez przenoszenia całego procesu do zewnętrznej infrastruktury.
Aplikacja analizuje m.in. statusy HTTP, przekierowania, canonicale, dyrektywy indeksowania, robots.txt, sitemap, nagłówki, metadane, linkowanie wewnętrzne, obrazy, dane strukturalne oraz sygnały e-commerce. Warstwa raportowa została oparta na dashboardach, tabelach, filtrach i widokach szczegółowych, tak aby użytkownik mógł szybko przejść od ogólnego stanu projektu do konkretnego problemu i listy adresów wymagających reakcji.
Istotną częścią realizacji były integracje z usługami Google: Search Console, GA4 i Merchant Center. Dzięki temu aplikacja może zestawiać dane crawla z widocznością, ruchem i statusem produktów, zachowując lokalny model pracy oraz bezpieczne przechowywanie tokenów OAuth.
Potwierdzone rezultaty
- Aplikacja desktopowa SEO
- Crawler local-first z lokalną bazą SQLite
- Analiza techniczna stron
- Reguły dla indeksowalności, canonicali, przekierowań, treści i linkowania
- Integracje danych
- Google Search Console, GA4, Merchant Center
- Audyt wydajności
- Lokalne uruchamianie Lighthouse
- Eksport danych
- CSV/JSON dla dalszej analizy
- Interfejs operacyjny
- Dashboardy, tabele, filtry i widoki szczegółowe
Zakres funkcjonalny zweryfikowano na podstawie kodu źródłowego, dokumentacji projektowej i struktury modułów aplikacji. Do publikacji nie użyto danych klienta, wyników produkcyjnych ani poufnych metryk biznesowych. Rezultaty opisują dostarczone funkcjonalności i architekturę, a nie deklarowane wzrosty KPI.
