seo-unlighthouselisted
Install: claude install-skill lasri97/next-seo
# 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).