Introduction
What SEO Agent does, and the ideas the rest of the docs build on.
What SEO Agent does
SEO Agent audits websites and turns the results into a short plan. It crawls a site like a search engine, runs deterministic checks for technical SEO, content, structured data, AI crawlers and Core Web Vitals, and scores the result. Then an AI analyst investigates the evidence with its own read-only tools and writes a handful of prioritised, evidence-backed fixes.
You approve or reject each fix. For approved fixes the analyst can draft the exact edits, and later audits measure whether each one worked. SEO Agent never changes your website.
The loop
- 1
Crawl
Follows links and sitemaps, respects robots.txt and renders JavaScript-only pages. See [Audits and the crawler](/docs/audits).
- 2
Detect
43 checks produce findings, which are tracked as issues across audits and turned into a 0–100 score. See [Checks, issues and the score](/docs/checks-and-scoring).
- 3
Investigate
The AI analyst plans, uses tools, reads your past decisions and goals, and writes recommendations. See [The AI analyst](/docs/ai-analyst).
- 4
Approve and draft
You decide; the analyst drafts the edits. See [Recommendations and change drafts](/docs/recommendations).
- 5
Measure
Later audits mark each approved fix improving, flat or worse.
Key concepts
| Term | Meaning |
|---|---|
| Organization | Owns sites, audits, settings and budgets. Everyone gets a personal one; teammates can be invited into it. |
| Site | A website you audit, identified by its URL. Competitor sites are audited too, but kept separate. |
| Audit | One crawl plus checks, score and (optionally) AI analysis. Only one audit per site runs at a time. |
| Finding | One check's result in one audit, with the affected URLs and evidence. |
| Issue | A finding tracked across audits: opened, still open, resolved or regressed. |
| Recommendation | A fix written by the analyst, citing findings as evidence, waiting for your decision. |
Where next
- [Quickstart](/docs/quickstart): your first audit in a few minutes.
- [MCP server](/docs/mcp): drive SEO Agent from Claude Code or another agent.