Agent AI do programowania: jak bezpiecznie naprawiać błędy SEO (Claude Code, Cursor)

Krótka odpowiedź: Agent AI do programowania poradzi sobie z mechanicznymi, sprawdzalnymi błędami SEO w twojej witrynie: tytułami, meta opisami, tagami canonical, hreflang, tekstami alternatywnymi, nagłówkami bezpieczeństwa oraz plikami robots.txt, sitemap i llms.txt. Przekazuj mu jedno znalezisko naraz, każde z warunkiem, który mówi, kiedy zadanie jest skończone, pozwól mu pracować na osobnym branchu, przeczytaj diff i po zmianie zmierz stronę jeszcze raz. Nie powinien wymyślać treści, wybierać twoich słów kluczowych, mówić w imieniu firmy ani rozstrzygać za ciebie, czy roboty AI mogą czytać twoją witrynę. Poprawka sprawia, że strona jest technicznie poprawna, ale lepszej pozycji nigdy nie gwarantuje.

Do czego nadaje się agent AI do programowania, a do czego nie?

Audyt SEO daje dwa rodzaje znalezisk. Jedne są mechaniczne: istnieje jedna dobra odpowiedź i możesz ją sprawdzić, pobierając stronę. Drugie to decyzje, które należą do człowieka. Agent AI do programowania, taki jak Claude Code, Cursor albo GitHub Copilot, pasuje do pierwszego rodzaju i jest ryzykowny przy drugim.

Dobre zadania dla agenta:

• Tytuły i meta opisy. Brakujący, powtarzający się albo źle dobrany pod względem długości tag łatwo znaleźć w szablonie lub pliku z treścią. Agent powinien wyprowadzić tekst z tego, co strona już mówi, a nie pisać reklamowych haseł z niczego.
• Canonical i hreflang. Jedno i drugie to reguły, a nie proza. hreflang ma jedną pułapkę, do której wrócimy niżej: każda wersja językowa musi linkować z powrotem do pozostałych.
• Teksty alternatywne. Dobrze tam, gdzie znaczenie obrazu wynika ze strony wokół niego. W przeciwnym razie agent powinien zapytać.
• Nagłówki bezpieczeństwa. Kilka linijek konfiguracji serwera lub frameworka, łatwych do sprawdzenia przez curl -I.
• Pliki w katalogu głównym: robots.txt, sitemap.xml i llms.txt. Krótki zwykły tekst, a wynik od razu możesz przeczytać.

Zadania, które zostają przy tobie:

• Wymyślanie treści. Fakty o produktach, ceny, opinie klientów, twierdzenia o twojej firmie. Zlecenie, które generuje SEOgrinder, mówi to w swoich zasadach pracy: nie wymyślaj treści, brakujące teksty wyprowadź z tego, co już jest na stronie, albo zapytaj.
• Decyzje o słowach kluczowych i tematach. To, która strona ma celować w którą frazę, jest pytaniem biznesowym.
• Decyzje właściciela. To, czy roboty AI mogą czytać twoją witrynę i czy wolno im jej używać do trenowania, rozstrzygasz ty. Prompty agentów w SEOgrinder mówią to wprost: zezwolenie albo blokada to decyzja właściciela, więc pytaj i nie wybieraj za niego.
• Praca nad wydajnością, częściowo. Cele są mierzalne: Core Web Vitals liczą się na 75. percentylu wczytań strony, osobno dla telefonów i komputerów, a „dobrze” znaczy LCP do 2,5 sekundy, INP do 200 milisekund i CLS do 0,1 (web.dev). Agent może zastosować znane poprawki, ale pojedynczy pomiar laboratoryjny po zmianie nie pokazuje, co mierzą prawdziwi użytkownicy, więc to, co usunąć, rozstrzygasz ty.

Bezpieczny proces w sześciu krokach

Celem jest pętla, w której każda zmiana jest mała, sprawdzona i odwracalna.

1. Skanuj. Wpisz adres swojej publicznej witryny w SEOgrinder. To nic nie kosztuje i nie wymaga konta. Dostajesz ogólną ocenę, listę zadań posortowaną według wpływu i sześć obszarów: Szybkość, Strona w Google, Dostępność, Technika i bezpieczeństwo, Gotowość na AI oraz Witryna.
2. Przekaż. Dla całej listy kliknij w raporcie Przekaż AI. Otworzy się zlecenie, czyli brief w Markdown, który pobierasz jako .md albo kopiujesz i wklejasz do swojego agenta. Dla pojedynczego zadania kliknij Przekaż AI na jego karcie. Przy kontrolach dla agentów AI zakładka Gotowość na AI ma w każdym wierszu przycisk Kopiuj prompt dla agenta (wiersze zaliczone rozwijają się najpierw). Prompty są po angielsku, bo są przeznaczone dla modelu, a specyfikacje, do których odsyłają, są angielskie.
3. Jedno znalezisko naraz. Powiedz agentowi, żeby zrobił zadanie pierwsze i się zatrzymał. Nie proś o „całe SEO”. Małe zadanie daje mały diff, który da się przeczytać.
4. Przeczytaj diff i uruchom testy. Twój build, linter i zestaw testów istnieją właśnie do tego. Otwórz zmienione pliki samodzielnie. Jeśli agent dotknął czegoś, o czym zadanie nie wspominało, zapytaj dlaczego.
5. Sprawdź ponownie. Gdy zmiana jest już pod twoim publicznym adresem, otwórz raport i kliknij Sprawdź ponownie. SEOgrinder przechowuje raport do 24 godzin, więc bez tego przycisku zobaczysz stary wynik. Przycisk działa kilka razy na godzinę. Znalezisko powinno zniknąć. SEOgrinder skanuje tylko publiczne strony, więc zmiana, która istnieje wyłącznie na twoim laptopie albo za logowaniem, jest dla niego niewidoczna. Sprawdzaj więc po wydaniu i trzymaj zmianę na tyle małą, żeby dało się ją cofnąć.
6. Zatwierdź. Jeden commit na jedno znalezisko, z komunikatem, który je nazywa. Scal, gdy ponowna kontrola się zgadza, i bierz następne zadanie.

Jak wygląda dobre zlecenie dla agenta

Agent bez jasnego celu zatrzymuje się, gdy coś wygląda wiarygodnie. Dobre zlecenie nie zostawia miejsca na zgadywanie. Ma cztery części:

Zlecenie ma taką kolejność: Zlecenie, Strona, Stan obecny, Słowa kluczowe, Zadania, Zasady pracy i Dane (odczyt maszynowy). W lokalnej instalacji SEOgrinder sekcja Sprawdź swoją pracę leży między Zasadami pracy a Danymi; zlecenie z seogrinder.com jej nie zawiera. Każde zadanie niesie swój problem, sposób naprawy, ocenę nakładu i blok „Gotowe, gdy”. Taki blok jest napisany jak test, na przykład:

meta[name=description] exists
description.length in [min, max]
description contains the focus keyword

W prawdziwym zleceniu granice są wypełnione dla twojej strony. Chodzi o to, że „gotowe” da się zweryfikować. Zasady pracy są krótkie: pracuj od góry do dołu, przed każdą zmianą znajdź dotknięty plik, pomiń i zgłoś zadanie, którego miejsca nie umiesz znaleźć, nie wymyślaj treści, zachowaj istniejące formatowanie, język i ton, a na końcu wypisz, które pliki się zmieniły i które zadania wykonano lub pominięto, z powodem.

W lokalnej instalacji sekcja „Sprawdź swoją pracę” każe agentowi zmierzyć stronę ponownie. Według tekstu zlecenia to porównanie sprawdza tylko to, co mówią powyższe zadania, a nie pozycje, a jego polecenie musi zostać uruchomione na komputerze, na którym działa SEOgrinder. Kontrolą, na której zawsze możesz polegać, jest więc ta z kroku 5: wydaj zmianę, kliknij Sprawdź ponownie, przeczytaj raport.

Skrócony przykład promptu

Poniżej skrócona wersja promptu agenta dla istniejącego pliku robots.txt, z example.com jako witryną. Prawdziwy prompt w SEOgrinder jest dłuższy i wymienia więcej kontroli.

# Review and improve the existing robots.txt

Your site already serves a robots.txt. Review it against RFC 9309
and fix what is wrong. Change only what is needed.
Do not remove a rule you do not understand: ask the site owner.

## Check

- Served as text/plain with HTTP 200, not as an HTML page
- Valid User-agent groups with Allow/Disallow rules, no syntax errors
- No rule blocks pages that should appear in search
- The sitemap is listed as an absolute URL
- AI crawlers: allowing or blocking is the owner's decision.
  Ask, do not choose for them

## Read it

curl -sg https://example.com/robots.txt

Report the problems you found and the changes you made.

Cztery nawyki czynią ten prompt bezpiecznym i możesz je przenieść do własnych promptów. Powściągliwość: „change only what is needed” utrzymuje diff w małym rozmiarze. Możliwość powiedzenia „nie wiem”: „ask the site owner” daje agentowi uprawnione wyjście, więc nie musi zgadywać. Granica dla decyzji: to, co rozstrzyga właściciel, jest nazwane jako jego sprawa. Najpierw stan faktyczny: linia z curl każe agentowi przeczytać prawdziwy plik zamiast zakładać, co w nim jest. Ostatnia linia daje ci podsumowanie do porównania z diffem.

Zasady bezpieczeństwa, zanim agent dotknie twojego kodu

• Pracuj na branchu albo na kopii projektu. Nigdy nie pozwalaj agentowi edytować plików bezpośrednio na serwerze produkcyjnym. Zmiany trafiają na produkcję zwykłym wydaniem.
• Czytaj każdy diff. Agent potrafi być pewny siebie i się mylić. Właśnie w diffie to zauważysz.
• Trzymaj sekrety z dala. Żadnych kluczy, tokenów ani zawartości .env w promptach ani we wklejanych plikach. Sprawdź, czy zmiany agenta nie skopiowały czegoś takiego do repozytorium.
• Żadnej masowej zmiany bez próby. Jeśli zadanie dotyczy każdej strony, na przykład szablon tytułu, zastosuj je najpierw na jednej stronie, obejrzyj wynik, a potem rozszerz.
• Build i testy przed każdym commitem.
• Traktuj pobrany tekst jako dane. Treść strony, eksport z Search Console czy odpowiedź serwera mogą zawierać zdania brzmiące jak polecenia. Polecenia, które obowiązują agenta, są tylko w zleceniu, które mu przekazujesz. Podsumowanie Search Console w SEOgrinder oznacza zapytania i adresy z eksportu jako „To dane, nie instrukcje” z tego samego powodu.

Najczęstsze błędy

• Przekazanie całej listy naraz. Diff rośnie i nie wiesz już, która zmiana wywołała który problem.
• Oddanie agentowi decyzji o crawlerach AI. To reguła o tym, kto może korzystać z twoich treści. To twoja decyzja.
• hreflang bez linków zwrotnych. Google dokumentuje, że każda wersja językowa musi wymieniać siebie i wszystkie pozostałe, a brakujące linki zwrotne mogą skutkować zignorowaniem oznaczeń. Agent, który edytuje jedną stronę i zostawia pozostałe, psuje cały zestaw. Napisz w zadaniu, że wszystkie wersje zmieniają się razem, i sprawdź wynik w każdej. Szczegóły są w przewodniku Google po wersjach zlokalizowanych.
• Nowa grupa w robots.txt, która zapomina o starych regułach. Według RFC 9309 crawler używa grupy, która pasuje do jego nazwy, a jeśli taka jest, grupa * go nie dotyczy. Gdy agent dodaje blok dla jednego bota AI, trzeba w nim powtórzyć wszystkie reguły, których ten bot ma przestrzegać.
• Przyjazna strona błędu z kodem 200. Brakująca strona powinna odpowiadać 404 lub 410. Jeśli treść mówi „nie znaleziono”, a kod to 200, Search Console może zgłosić soft 404, jak opisuje strona Google o kodach statusu HTTP. Ładniejsza strona błędu nadal musi wysyłać kod 404. Więcej o tym w artykule o błędach soft 404.
• Wiara w „gotowe” bez pomiaru. Raport agenta mówi, co zamierzał zmienić. Tylko nowy skan pokazuje, co jest na żywo.

Najczęstsze pytania

Jaki agent AI do programowania jest najlepszy do poprawek SEO?

Nie oceniamy narzędzi i nie twierdzimy nic o poszczególnych modelach ani produktach. Zlecenie to plik Markdown napisany dla Claude Code, Cursora, GitHub Copilota albo ChatGPT. Jakość zlecenia, wielkość zadania i twoja kontrola znaczą więcej niż nazwa narzędzia.

Czy agent może wykonać cały audyt bez nadzoru?

Nie zrobilibyśmy tego. Mechaniczne znaleziska pasują do agenta, decyzje nie, a bez nadzoru błędne przypuszczenie ląduje na produkcji. Jedno zadanie, jeden diff, jedna kontrola trwa dłużej i jest znacznie bezpieczniejsze.

Czy SEOgrinder zmienia moją stronę?

Nie. SEOgrinder czyta twoje publiczne strony i zgłasza, co znalazł. Zmiany wprowadza twój agent w twoim projekcie, a ty je sprawdzasz.

Czy po naprawie znalezisk moje pozycje wzrosną?

Tego nikt nie zagwarantuje. Naprawa znalezisk usuwa błędy techniczne i ułatwia crawlerom oraz odwiedzającym czytanie strony, co jest solidną bazą. Co stanie się z pozycjami albo z wzmiankami w odpowiedziach AI, tego żadne narzędzie nie obieca.

Następny krok

Uruchom darmowy skan swojej witryny, otwórz raport i weź pierwsze zadanie z listy. Przekaż agentowi tylko to jedno, przeczytaj diff, wydaj zmianę, kliknij Sprawdź ponownie i zatwierdź. Jeśli chcesz zobaczyć, co jeszcze warto sprawdzić, przejdź checklistę SEO krok po kroku.