Pełny audyt SEO bezpośrednio w terminalu dzięki wtyczce Claude SEO

Typowy audyt SEO zwykle zamienia się w żmudne zadanie. Otwierasz Ahrefs lub Screaming Frog, eksportujesz gigabajty tabel CSV, a potem spędzasz długie godziny próbując ustalić, które z pięciuset znalezionych błędów faktycznie wpływają na ruch, a które to tylko szum. Następnie musisz ręcznie przenieść zadania do backlogu deweloperów.

Niedawno natknąłem się na projekt open-source claude-seo. To rozszerzenie dla narzędzia CLI Claude Code, które zajmuje się całą rutynową pracą analizy SEO i dostarcza gotową mapę drogową bezpośrednio w konsoli.

Co sprawia, że to narzędzie jest interesujące

Projekt rozwiązuje główny problem większości usług SEO: nie generuje po prostu ściany metryk, ale buduje weryfikację wokół falsyfikowalności. Każda rekomendacja w raporcie ma cztery wymagane pola:

• Obserwacja ze źródła (na czym opiera się wniosek)
• Połączenie z innymi zadaniami w grafie zależności
• Jasne kryteria weryfikacji ("jak rozpoznać, że hipoteza nie zadziałała")
• Wiodący wskaźnik do śledzenia wyników

Wewnątrz wtyczki pracują 24 podmoduły i 18 wyspecjalizowanych agentów. Po uruchomieniu audytu strony system uruchamia do 15 procesów równoległych. Jednocześnie analizują one stronę techniczną, poprawność mikrodanych Schema.org, jakość treści zgodnie z wytycznymi E-E-A-T oraz gotowość strony do odpowiedzi AI w wyszukiwarce (GEO).

Skupienie na nowym typie wyników wyszukiwania

Twórca projektu zorientował się na aktualne wytyczne Google dotyczące optymalizacji AI. Narzędzie ocenia cytowalność bloków tekstowych (idealny fragment to 134 do 167 słów z kompleksową odpowiedzią na pytanie), gęstość atrybucji faktów oraz obecność marki na zewnętrznych platformach takich jak Reddit, YouTube i LinkedIn.

Jednocześnie autor otwarcie obala popularne mity. Na podstawie źródeł pierwotnych wtyczka uwzględnia, że plik robots.txt obecnie nie wpływa na cytowania Google, sztuczne dzielenie treści na chunki nie jest wymagane, a przepisywanie tekstów pod kątem słów kluczowych AI jest bezcelowe — wyszukiwarki świetnie radzą sobie ze zrozumieniem synonimów.

Co wtyczka potrafi w praktyce

Narzędzie dodaje 32 polecenia do interfejsu Claude Code. Oto główne obszary pracy:

Szybki audyt i analiza techniczna

Polecenie /seo audit https://example.com uruchamia równoległe sprawdzenie całej strony. Jeśli potrzebujesz analizy pojedynczej strony, polecenie /seo page daje ci dokładny wycinek nagłówków, tagów meta i struktury. Metryki techniczne są sprawdzane przez /seo technical — śledzi Core Web Vitals (LCP, INP, CLS) bez przestarzałych parametrów jak FID.

Walidacja Schema.org

Za pomocą /seo schema możesz znaleźć istniejące bloki JSON-LD, zweryfikować ich poprawność i natychmiast wygenerować brakujące znaczniki. Wtyczka wie o wycofaniu rich-results dla FAQ i HowTo, więc nie będzie sugerować marnowania czasu na przestarzałe typy schematów.

SEO lokalne i marketplace'y

Polecenia /seo local i /seo maps analizują sygnały Google Business Profile, spójność adresu i numeru telefonu (NAP) w katalogach oraz sentyment recenzji. Aby chronić strony przed karami za doorway pages, wtyczka ma wbudowane limity liczby stron geo.

Jak zainstalować i uruchomić

Narzędzie wymaga Claude Code CLI oraz Pythona 3.10 lub nowszego. Wtyczkę instaluje się jednym poleceniem wewnątrz Claude Code:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

Polecenie /seo setup tworzy izolowane środowisko Python w folderze wtyczki i pobiera Chromium dla Playwright. Pakiety globalne nie są instalowane w systemie.

Jeśli wolisz zwykły skrypt bash:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Po instalacji możesz od razu wywoływać polecenia:

# Запустить аудит сайта
/seo audit https://mysite.com

# Проверить разметку Schema
/seo schema https://mysite.com/product/123

# Оценить готовность контента к AI-выдаче
/seo geo https://mysite.com/blog/article

Praca z API i rozszerzeniami

Podstawowa funkcjonalność wtyczki działa lokalnie i za darmo. Nie potrzebuje kluczy API do parsowania stron i budowania raportów. Ale jeśli połączysz klucze Google, otworzą się dodatkowe możliwości:

1. Na poziomie podstawowym (klucz API) pobierane są rzeczywiste dane PageSpeed Insights i 25-tygodniowe trendy CrUX.
2. Przy połączeniu OAuth lub konta serwisowego dodawana jest integracja z Google Search Console i Indexing API.
3. Połączenie GA4 zapewnia analitykę ruchu organicznego i stron docelowych.
4. Dla deweloperów dostępne jest połączenie z Google Ads API do szacowania wolumenu popytu wyszukiwania.

Dodatkowo wspierane są zewnętrzne serwery MCP: Ahrefs, DataForSEO, Firecrawl, Unlighthouse i SE Ranking.

Gdzie narzędzie się przyda

• Wewnętrzne zespoły deweloperskie i SEO. Wygodnie uruchomić /seo audit dzień przed sprintem lub przed wydaniem, aby wyłapać zepsute canonicale, problemy z hydracją na Next.js czy uszkodzone znaczniki.
• Freelancerzy. Podczas rozmowy z klientem możesz w 10 minut przygotować pełny raport w Markdown z ocenami od 0 do 100 i jasną listą poprawek.
• Agencje. Zamiast ręcznie kompilować kwartalne raporty, możesz skonfigurować cotygodniowe uruchomienie skryptu i śledzić regresje za pomocą modułu /seo drift.

Ograniczenia i słabe strony

Narzędzie nie jest idealne. Na stronach z ciężkim Client-Side Rendering (CSR) lub skomplikowaną hydracją zależną od przewijania przez użytkownika, headless renderer czasami pomija treść, tworząc fałszywe pozytywy. W takich przypadkach autor zaleca uruchomienie sub-agenta seo-visual i porównanie jego snapshotu z surowym renderem HTML.

Drugi punkt — bez zewnętrznych płatnych API (Ahrefs lub DataForSEO) nie otrzymasz pełnej analizy linków zwrotnych konkurencji. Wtyczka świetnie radzi sobie z audytami On-Page i technicznymi, ale dane Off-Page są ograniczone do darmowych źródeł jak Bing czy Common Crawl.

claude-seo to dobry przykład tego, jak agenci LLM mogą uprościć rutynową analitykę. Projekt jest rozpowszechniany na licencji MIT, kod jest w pełni otwarty, a wtyczka nie wysyła twoich danych na serwery stron trzecich. Jeśli używasz Claude Code w codziennej pracy i zajmujesz się web developmentem w jakikolwiek sposób, zainstalowanie i przetestowanie tego narzędzia zdecydowanie warto.