Documentation

SEO Audit Engine

@shaw/seo-audit — structured technical SEO analysis, plus the audit app's server-side Lighthouse integration.

The engine

auditWebsite(url) normalizes and fetches a page with SSRF-aware guards, then produces a structured report: an overall score, per-category scores, and concrete findings with recommended fixes.

  • Crawlability: HTTP status, redirects, robots directives, canonical.
  • Metadata: titles, descriptions, Open Graph, viewport, language.
  • Content structure: heading hierarchy and link inventory.
  • Images: alt coverage and delivery details.
  • Structured data: JSON-LD block detection.

Lighthouse integration

The audit app adds Google PageSpeed Insights (Lighthouse) with mobile and desktop strategies: performance, accessibility, best-practices, and SEO scores plus core metrics. The PAGESPEED_API_KEY lives server-side only, and a PageSpeed failure never breaks the SEO report — the audit degrades gracefully.