Website Audit Agent
An AI agent that audits any website in under a minute and turns 35+ technical checks into a clear, client-ready report with fixes ranked by impact.
The problem
Small businesses rarely know why their website is not bringing in customers, and agencies spend hours doing manual audits before they can even pitch a client.
The approach
A three-step agent: it crawls the page, runs objective checks that score each area out of 100, and then uses an LLM only where it adds value: explaining the findings in plain English and prioritising the fixes.
How it is built
A standard-library Python crawler fetches the page, follows redirects, checks robots.txt, the sitemap and up to 25 links in parallel, and parses the HTML for SEO, performance, mobile, content and security signals. Each check is weighted and scored. A FastAPI backend stores every audit in SQLite, and the AI step asks the model for structured JSON: a summary, prioritised fixes with impact and effort, a content review and a rewritten title and meta description. Without an API key it falls back to a rule-based report.
My role
Full design and development of Website Audit Agent.
Delivered functionality
A working agent with a web dashboard, audit history, a printable white-label client report (Download PDF) and CSV export.
What the agent does
- Crawl: fetches the page, robots.txt and sitemap, and checks up to 25 internal and external links for errors.
- SEO: title and meta length, H1/H2 structure, image alt text, canonical, noindex, schema, Open Graph and broken links.
- Performance and mobile: server response, page size, compression, render-blocking scripts, caching, lazy loading, viewport and layout shift.
- Content: word count, readability, contact details, call to action and target keyword placement.
- Security: HTTPS, mixed content and security headers.
- AI report: plain-English summary, top fixes ranked by impact and effort, quick wins and a new SEO title and meta description.
- Client-ready report with the client name and agency branding, ready to download as a PDF.
Inside Website Audit Agent
DEMO VIDEOReal demo on this portfolio site: URL in, score out of 100 across five areas, AI summary and fixes, then the client report.