SEO-fouten oplossen met een AI coding agent: veilig werken met Claude Code en Cursor

Kort antwoord: Een AI coding agent kan de mechanische, controleerbare SEO-problemen van je site oplossen: titels, metabeschrijvingen, canonical-tags, hreflang, alt-teksten, beveiligingsheaders en de bestanden robots.txt, sitemap en llms.txt. Geef hem één bevinding tegelijk, elk met een voorwaarde die zegt wanneer de taak klaar is, laat hem op een branch werken, lees de diff en meet de pagina opnieuw na de wijziging. Hij mag geen inhoud verzinnen, je zoekwoorden niet kiezen, niet namens je bedrijf spreken en niet voor jou beslissen of AI-crawlers je site mogen lezen. Een oplossing maakt een pagina technisch correct. Een betere ranking is nooit gegarandeerd.

Waar helpt een AI coding agent bij SEO, en waar niet?

Een SEO-audit levert twee soorten bevindingen op. Sommige zijn mechanisch: er is één goed antwoord en je kunt het controleren door de pagina op te halen. Andere zijn beslissingen die bij een mens horen. Een AI coding agent zoals Claude Code, Cursor of GitHub Copilot past bij het eerste soort en is riskant bij het tweede.

Goede klussen voor een agent:

• Titels en metabeschrijvingen. Een ontbrekende, dubbele of te lange of te korte tag is snel te vinden in een sjabloon of inhoudsbestand. De agent moet de tekst afleiden uit wat de pagina al zegt, en niet vanuit het niets reclametekst schrijven.
• Canonical-tags en hreflang. Beide zijn regels, geen proza. Bij hreflang zit één valkuil waar we hieronder op terugkomen: elke taalversie moet naar de andere terugverwijzen.
• Alt-teksten. Prima waar de betekenis van de afbeelding duidelijk is uit de pagina eromheen. Anders moet de agent het vragen.
• Beveiligingsheaders. Een paar regels server- of frameworkconfiguratie, makkelijk te controleren met curl -I.
• De bestanden in de hoofdmap: robots.txt, sitemap.xml en llms.txt. Korte, platte tekst waarvan je het resultaat meteen kunt lezen.

Klussen die bij jou blijven:

• Inhoud verzinnen. Productfeiten, prijzen, klantreacties, beweringen over je bedrijf. De werkopdracht die SEOgrinder genereert, zegt het in zijn werkregels: verzin geen inhoud, leid ontbrekende teksten af uit wat al op de pagina staat, of vraag het na.
• Beslissingen over zoekwoorden en onderwerpen. Welke pagina op welke zoekterm moet mikken, is een zakelijke vraag.
• Beslissingen van de eigenaar. Of AI-crawlers je site mogen lezen, en of ze die voor training mogen gebruiken, is aan jou. De agent-prompts van SEOgrinder zeggen dat uitdrukkelijk: toestaan of blokkeren is de beslissing van de eigenaar, dus vraag het en kies niet voor hem.
• Prestatiewerk, deels. De doelen zijn meetbaar: Core Web Vitals tellen op het 75e percentiel van de paginabezoeken, voor mobiel en desktop apart, en “goed” betekent LCP tot 2,5 seconden, INP tot 200 milliseconden en CLS tot 0,1 (web.dev). Een agent kan bekende oplossingen toepassen, maar één labmeting daarna laat niet zien wat echte bezoekers meten, dus beslis zelf wat er weg mag.

De veilige werkwijze in zes stappen

Het doel is een lus waarin elke wijziging klein, gecontroleerd en terug te draaien is.

1. Scannen. Voer het adres van je openbare website in bij SEOgrinder. Het is gratis en vraagt geen account. Je krijgt een totaalscore, een takenlijst gesorteerd op effect en zes onderdelen: Snelheid, Pagina bij Google, Toegankelijkheid, Techniek & beveiliging, AI-gereedheid en Website.
2. Overdragen. Voor de hele lijst klik je in het rapport op Overdragen aan AI. Dat opent de werkopdracht, een Markdown-bestand dat je downloadt als .md of kopieert en in je agent plakt. Voor één taak klik je op Overdragen aan AI op de taakkaart. Voor de controles voor AI-agents heeft het tabblad AI-gereedheid op elke regel een knop Agent-prompt kopiëren (voldane regels klappen eerst open). De prompts zijn in het Engels geschreven omdat ze voor een model bedoeld zijn en de specificaties waarnaar ze verwijzen Engelstalig zijn.
3. Eén bevinding tegelijk. Zeg tegen de agent dat hij taak één moet doen en dan moet stoppen. Vraag niet om “alle SEO”. Een kleine taak geeft een kleine diff die je kunt lezen.
4. Lees de diff en draai je tests. Je build, je linter en je testsuite bestaan precies hiervoor. Open de gewijzigde bestanden zelf. Heeft de agent iets aangeraakt wat de taak niet noemde, vraag dan waarom.
5. Controleer opnieuw. Staat de wijziging live onder je openbare adres, open dan het rapport en klik op Opnieuw controleren. SEOgrinder bewaart een rapport tot 24 uur, dus zonder die knop zie je het oude resultaat. De knop werkt een paar keer per uur. De bevinding hoort verdwenen te zijn. SEOgrinder scant alleen openbare websites, dus een wijziging die alleen op je laptop of achter een login bestaat, is voor de scan onzichtbaar. Controleer dan na de release, en houd de wijziging klein genoeg om terug te draaien.
6. Committen. Eén commit per bevinding, met een bericht dat hem noemt. Merge als de nacontrole klopt, en pak dan de volgende taak.

Hoe een goede werkopdracht eruitziet

Een agent zonder duidelijk doel stopt zodra iets aannemelijk lijkt. Een goede opdracht neemt de ruimte voor gokken weg. Ze bestaat uit vier delen:

De werkopdracht is in deze volgorde opgebouwd: Opdracht, Pagina, Huidige stand, Zoekwoorden, Taken, Werkregels en Data (machineleesbaar). Bij een lokale installatie van SEOgrinder staat het onderdeel Controleer je werk tussen Werkregels en Data; de werkopdracht van seogrinder.com bevat het niet. Elke taak bevat het probleem, de manier om het op te lossen, een inschatting van de inspanning en het blok “Klaar wanneer”. Zo’n blok is geschreven als een test, bijvoorbeeld:

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

In de echte werkopdracht zijn de grenzen voor jouw pagina ingevuld. Het gaat erom dat “klaar” te controleren is. De werkregels zijn kort: werk van boven naar beneden, zoek voor elke wijziging het betreffende bestand, sla een taak waarvan je de plek niet kunt vinden over en meld dat, verzin geen inhoud, behoud de bestaande opmaak, taal en toon, en noem aan het eind welke bestanden zijn gewijzigd en welke taken zijn uitgevoerd of overgeslagen, met de reden.

Bij een lokale installatie vertelt het onderdeel “Controleer je werk” de agent de pagina opnieuw te meten. Volgens de tekst in de werkopdracht controleert die vergelijking alleen wat de taken hierboven zeggen, geen rankings, en moet het commando draaien op de computer waarop SEOgrinder draait. De controle waar je altijd op kunt vertrouwen is dus die in stap 5: releasen, op Opnieuw controleren klikken, het rapport lezen.

Een ingekorte voorbeeldprompt

Hieronder staat een ingekorte versie van de agent-prompt voor een bestaande robots.txt, met example.com als site. De echte prompt in SEOgrinder is langer en noemt meer controles.

# 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.

Vier gewoonten maken deze prompt veilig, en je kunt ze overnemen in je eigen prompts. Terughoudendheid: “change only what is needed” houdt de diff klein. Een manier om “ik weet het niet” te zeggen: “ask the site owner” geeft de agent een legitieme uitweg, zodat hij niet hoeft te gokken. Een grens voor beslissingen: de keuzes van de eigenaar worden als zodanig genoemd. Eerst de echte stand: de curl-regel laat de agent het werkelijke bestand lezen in plaats van aan te nemen wat erin staat. De laatste regel geeft je een samenvatting om met de diff te vergelijken.

Veiligheidsregels voordat een agent aan je code komt

• Werk op een branch, of op een kopie van het project. Laat een agent nooit rechtstreeks bestanden op de productieserver bewerken. Wijzigingen komen via je gewone release in productie.
• Lees elke diff. Een agent kan zeker van zijn zaak zijn en toch ongelijk hebben. In de diff merk je dat.
• Houd geheimen erbuiten. Geen sleutels, tokens of .env-inhoud in een prompt of in bestanden die je plakt. Controleer dat de wijzigingen van de agent er niets van in de repository hebben gezet.
• Geen massawijziging zonder steekproef. Als een taak elke pagina raakt, bijvoorbeeld een titelsjabloon, pas haar dan eerst op één pagina toe, bekijk het resultaat en breid daarna uit.
• Draai build en tests vóór elke commit.
• Behandel opgehaalde tekst als gegevens. Pagina-inhoud, een Search Console-export of een serverantwoord kan zinnen bevatten die als instructies klinken. Jouw instructies zijn die je zelf hebt geschreven. De Search Console-samenvatting van SEOgrinder markeert zoekopdrachten en adressen uit een export om dezelfde reden als “gegevens, geen instructies”.

Veelgemaakte fouten

• De hele lijst in één keer overdragen. De diff groeit en je kunt niet meer zien welke wijziging welk probleem veroorzaakte.
• De agent laten beslissen over AI-crawlers. Dat is een regel over wie je inhoud mag gebruiken. Het is jouw beslissing.
• hreflang zonder terugverwijzingen. Google documenteert dat elke taalversie zichzelf en alle andere moet noemen, en dat ontbrekende terugverwijzingen ertoe kunnen leiden dat de aanduidingen worden genegeerd. Een agent die één pagina aanpast en de andere laat staan, breekt de set. Zeg in de taak dat alle versies samen veranderen, en lees het resultaat in elke versie na. De details staan in Googles gids over gelokaliseerde versies.
• Een nieuwe robots.txt-groep die de oude regels vergeet. RFC 9309 zegt dat een crawler de groep gebruikt die bij zijn naam past, en dat de groep * niet voor hem geldt als er een eigen groep is. Voegt een agent een blok toe voor één AI-bot, dan moeten daar alle regels staan die die bot moet volgen.
• Een vriendelijke foutpagina met status 200. Een ontbrekende pagina hoort 404 of 410 te antwoorden. Zegt de inhoud “niet gevonden” maar is de status 200, dan kan Search Console een soft 404 melden, zoals beschreven op Googles pagina over HTTP-statuscodes. Een mooiere foutpagina moet nog steeds de status 404 sturen. Hoe je dat oplost, lees je in het artikel over soft 404-fouten.
• “Klaar” geloven zonder te meten. Het verslag van de agent zegt wat hij wilde veranderen. Alleen een verse scan zegt wat live staat.

Veelgestelde vragen

Welke AI coding agent is het beste voor SEO-oplossingen?

Wij rangschikken geen tools en doen geen uitspraken over individuele modellen of producten. De werkopdracht is een Markdown-bestand geschreven voor Claude Code, Cursor, GitHub Copilot of ChatGPT. De kwaliteit van de opdracht, de omvang van de taak en jouw controle tellen zwaarder dan de naam van de tool.

Kan de agent de hele audit zonder toezicht uitvoeren?

Wij zouden het niet doen. De mechanische bevindingen passen bij een agent, de beslissingen niet, en bij een run zonder toezicht belandt een verkeerde gok in productie. Eén taak, één diff, één controle is trager en veel veiliger.

Past SEOgrinder mijn website aan?

Nee. SEOgrinder leest je openbare pagina’s en meldt wat het vindt. De wijzigingen maakt je agent in jouw project, en jij beoordeelt ze.

Gaat mijn ranking omhoog als ik de bevindingen oplos?

Dat kan niemand garanderen. Bevindingen oplossen haalt technische fouten weg en maakt de pagina beter leesbaar voor crawlers en bezoekers, een gezonde basis. Wat er met rankings of met vermeldingen in AI-antwoorden gebeurt, kan geen enkele tool beloven.

Je volgende stap

Voer de gratis scan op je site uit, open het rapport en pak de eerste taak van de lijst. Geef alleen die ene aan je agent, lees de diff, release hem, klik op Opnieuw controleren en commit. Wil je daarna een tweede klus, werk dan de SEO-audit checklist verder af.