seo-unlighthouse runs the MIT-licensed Unlighthouse CLI against every route of a site, up to a configurable cap, and aggregates the results. It suits sites too large for the PageSpeed Insights free quota, CI checks, restricted environments and quick regression checks after a deploy.
The wrapper reads the CLI’s result file and returns the route count, a median score per Lighthouse category and the per-route breakdown.
What You Get
- Lighthouse results for up to 200 routes per run
- Median scores for performance, accessibility, best practices and SEO
- A per-route breakdown saved as ci-result.json
- Mobile or desktop form factor
- A route cap and timeout you can change
Common Use Cases
- Check Core Web Vitals across a large site without API quota
- Run a regression check after a deploy
- Audit pages from a restricted network
- Save reports to a folder for a client
What Makes It Unique
It measures every page locally with no quota, and it writes its own config file because the CLI has no max-routes flag. Single-URL field data goes to seo-google, and LCP detail goes to a separate script.
Under The Hood
The skill runs a bundled Python wrapper through the claude-seo launcher. The wrapper checks the target URL with the shared URL safety guard, writes an Unlighthouse config file, starts the Unlighthouse CLI as a subprocess with a timeout, and reads the result JSON it produces. The CLI loads the pages in a headless browser and sends requests to the site you name. The install script pre-warms the npm package.