seo-unlighthouse

Runs Lighthouse audits across every URL on a site via the Unlighthouse CLI.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/coseto6125/claude-setup --skill seo-unlighthouse-coseto6125
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: seo-unlighthouse
Source: https://github.com/coseto6125/claude-setup/tree/main/skills/seo-unlighthouse
Command: npx skills add https://github.com/coseto6125/claude-setup --skill seo-unlighthouse-coseto6125

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unlighthouse.

What problem does it solve? PageSpeed Insights' free quota (25k queries per day) is not enough to audit every page on a large site, and it cannot run offline or in restricted CI environments. This Skill runs Lighthouse locally against every URL on a site and aggregates the results without burning API quota. ## Core Features & Use Cases - Site-wide Lighthouse audits: Crawls up to a configurable number of routes (default 200) and runs Lighthouse on each, returning median performance, accessibility, best-practices, and SEO scores. - Device and output control: Supports mobile or desktop form factors, custom route caps, and persistent output directories with JSON and HTML reports. - Use Case: After a deploy, run a site-wide regression check with /seo unlighthouse https://example.com --max-routes 50 --output-dir ./reports and compare the median performance score in ci-result.json against the previous baseline. ## Quick Start Ask the assistant to run an Unlighthouse audit of your site, for example: run a mobile Lighthouse audit of https://example.com across up to 200 routes and show me the aggregate scores.

Frequently Asked Questions about seo-unlighthouse

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Lighthouse on every page of my website?▼

Use the Unlighthouse CLI, which crawls your site's routes and runs Lighthouse on each one. Invoke it with `/seo unlighthouse <url>` to audit up to 200 routes and receive aggregate JSON and HTML reports.

What is a free alternative to the PageSpeed Insights API for bulk audits?▼

Unlighthouse is an MIT-licensed CLI that runs Lighthouse locally against every URL on a site with no API key and no quota. It suits large sites that exceed PageSpeed Insights' 25k queries-per-day free tier.

Does Unlighthouse require an API key or Node.js?▼

Unlighthouse requires no API key but does require Node 18 or later on your PATH plus the unlighthouse npm package. Run the provided install script to pre-warm the setup before first use.

Can I run Lighthouse audits offline or in CI pipelines?▼

Yes, Unlighthouse runs Lighthouse locally, so it works offline and in restricted CI environments. Results are written to an output directory as ci-result.json plus an HTML report for pipeline consumption.

How do I limit the number of pages Unlighthouse audits?▼

Pass the --max-routes flag, for example `/seo unlighthouse <url> --max-routes 50`, to cap the number of crawled routes. You can also set --output-dir to persist reports and --device desktop to change the form factor.

When should I use PageSpeed Insights instead of Unlighthouse?▼

Use PageSpeed Insights or CrUX when you need real-user field data for a single URL rather than lab measurements. Unlighthouse provides synthetic local audits, so it cannot report actual Chrome user experience metrics.