Lesson 2 · 18 min
The first agent worth building is the one that only reads. It runs the X-ray, runs claude-seo, and returns a list of problems, each with the line that proves it. It fixes nothing: you decide what to change, and the 2026 yardstick filters out what's just a fad.
Start the lesson
Goal: run the read-only X-ray and claude-seo, and have the agent list problems with evidence, changing nothing.
Tap each block.
The auditor only reads. Whoever writes to the site goes through a gate.
Tap each step.
Run the method's auditoria.sh with the home page and the pages that matter, and save the output to a file. That's the evidence the agent will read.
The script only makes read requests (curl). It can run on any public site, including a competitor's.
claude-seo needs Python 3.10 or higher and Claude Code. The /seo audit, /seo technical, and /seo geo commands run without paying anything beyond your subscription.
The DataForSEO extension (search volume, SERP, backlinks) requires a paid account: the README mentions a minimum top-up of US$ 50 and US$ 1 for a test (README from 03/06/2026; check the site).
Prefer to clone and read install.sh before running it. A script piped straight into bash runs without you seeing what it does.
Ask for a table: finding, evidence line copied from the file, severity, and proposed fix. And say what it can't do: change files, run commands that write, call APIs.
A finding without an evidence line is discarded, as in the check from lesson 3.
claude-seo's GEO module treats llms.txt as an emerging standard, and its schema reference on FAQ dates from 2023. Mark those items as [yardstick] and decide by what holds in 2026.
Blocking a training bot doesn't block a search bot: robots.txt is decided by purpose (course 1, lesson 6).
Swap the address for your site.
git clone https://github.com/inematds/inemaseo-metodo.git cd inemaseo-metodo tools/auditoria.sh https://www.seusite.com /pagina-1/ /pagina-2/ > auditoria.txt
git clone https://github.com/AgriciDaniel/claude-seo.git cd claude-seo less install.sh # read it before running ./install.sh claude # opens Claude Code /seo audit https://www.seusite.com /seo technical https://www.seusite.com /seo geo https://www.seusite.com
Read auditoria.txt (and the /seo audit report, if there is one). Return a table with up to 10 findings: finding | evidence line copied from the file | severity (high/medium/low) | proposed fix. Rules: - A finding without an evidence line doesn't go in. - Do not change any file, do not run any command that writes, do not call any API. - Mark [yardstick] every recommendation about llms.txt, FAQ, or "optimizing for AI". - Bots in robots.txt: separate search, user action, and training.
$ tools/auditoria.sh https://www.inema.club == Redirecionamentos http://www.inema.club/ -> 308 https://www.inema.club/ https://inema.club/ -> 308 https://www.inema.club/ https://www.inema.club/ -> 200 == robots.txt User-Agent: * Allow: / User-Agent: OAI-SearchBot User-Agent: Claude-SearchBot User-Agent: ClaudeBot User-Agent: PerplexityBot User-Agent: Googlebot User-Agent: Bingbot Allow: / Host: https://www.inema.club Sitemap: https://www.inema.club/sitemap.xml Sitemap: https://www.inema.club/courses-sitemap.xml == Sitemaps https://www.inema.club/sitemap.xml: 83 URLs, 60 anotações hreflang https://www.inema.club/courses-sitemap.xml: 100 URLs, 0 anotações hreflang == llms.txt: 200 == Páginas -- / [200] title: Aprender Inteligência Artificial na prática | INEMA.club canonical: https://www.inema.club/ hreflang: hrefLang="en" hrefLang="es" hrefLang="pt-BR" hrefLang="x-default" links internos no HTML: 27
Excerpt: the JSON-LD block was omitted.
Use your own site. If you don't have one, use a public site you know well.
Run auditoria.sh on the home page and 3 more important pages, and save the output to auditoria.txt. If you have Claude Code, also run /seo technical on the home page.
Done when: auditoria.txt exists with the 4 pages, each with status, title, canonical and the internal link count.
Give the auditor's request to the agent. Check each evidence line against the file and write your decision next to each finding: fix, ignore (with the reason) or [régua].
Done when: you have 5 findings, each with a line that really exists in auditoria.txt and your decision, and the project's git status shows the agent changed nothing.
The explanation appears after your answer.
Question 1 of 4
The auditor agent flagged a problem, but didn't copy any line from the output. What should you do?skill
Question 2 of 4
What in claude-seo requires a paid account?
Question 3 of 4
In the real output, ClaudeBot appears in the group with OAI-SearchBot and Claude-SearchBot. What is the finding?
Question 4 of 4
The GEO module suggests creating llms.txt to show up more in AI answers. How should you handle it?
Choose an option. The explanation appears after your attempt.