Multi-Page SEO Audit with Lighthouse

v20260613

seo-unlighthouse

Performs comprehensive, multi-page Lighthouse audits across an entire website. This tool is a robust, quota-free alternative to services like PageSpeed Insights, making it ideal for large sites or CI/CD pipelines where API limits are a concern. It aggregates key metrics such as performance, accessibility, and SEO scores across all audited routes.

SEO Lighthouse Performance Audit Automation Web Development Testing

Get Skill

340 downloads

Overview

seo-unlighthouse

Run Lighthouse against every URL on a site (up to a configurable cap) and aggregate the results. Useful when:

PageSpeed Insights' free quota (25k QPD) isn't enough for a large site.
You want offline / local CWV measurement (CI integration, restricted environments).
You need a quick site-wide regression check after a deploy.

Prerequisites

Run extensions/unlighthouse/install.sh (no API key needed).
Node 18+ on $PATH.

Routing

Command	Effect
`/seo unlighthouse <url>`	Mobile audit, up to 200 routes, JSON+HTML report in a temp dir
`/seo unlighthouse <url> --device desktop`	Desktop form factor
`/seo unlighthouse <url> --max-routes 50 --output-dir ./reports`	Cap + persist

All flags forward to scripts/unlighthouse_run.py which handles url_safety pre-flight and subprocess timeout management.

Output handling

The wrapper reads ci-result.json from the Unlighthouse output dir and returns it parsed. Aggregate fields:

score.performance (median across audited routes)
score.accessibility, score.bestPractices, score.seo
Per-route breakdown is available in <output_dir>/ci-result.json

Cross-skill delegation

For single-URL field data (CrUX), use seo-google psi / seo-google crux.
For LCP subpart decomposition on slow pages, use the scripts/lcp_subparts.py workflow (Phase C).

Info

Category Development

Name seo-unlighthouse

Version v20260613

Size 1.72KB

Source AgriciDaniel/claude-seo

Updated At 2026-07-02