seo-unlighthouse

Run Lighthouse audits across every site URL and aggregate category scores into JSON reports.

19.4k|2.8k|Updated Feb 7, 2026
Ready to run
npx skills add https://github.com/AgriciDaniel/claude-seo --skill seo-unlighthouse-agricidaniel
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: seo-unlighthouse
Source: https://github.com/AgriciDaniel/claude-seo/tree/main/extensions/unlighthouse/skills/seo-unlighthouse
Command: npx skills add https://github.com/AgriciDaniel/claude-seo --skill seo-unlighthouse-agricidaniel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running PageSpeed Insights against every URL on a large site quickly exhausts the free API quota and requires network access. This Skill runs Lighthouse locally across an entire site, aggregating results without burning API limits or requiring external connectivity. ## Core Features & Use Cases - Site-Wide Audits: Crawl and audit every URL on a domain up to a configurable route cap. - Local & Offline Execution: Measure Core Web Vitals and category scores in CI pipelines or restricted environments without API keys. - Flexible Reporting: Generate JSON and HTML reports with median aggregate scores for performance, accessibility, best-practices, and SEO. - Use Case: After deploying a new feature, run a quick site-wide regression check to catch performance drops before users report them. ## Quick Start Run a mobile Lighthouse audit on https://example.com and save the aggregated report to ./reports.

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 audits across every page on my website?▼

Use the Unlighthouse CLI to crawl your site and run Lighthouse on each discovered route. The command audits up to 200 routes by default and returns aggregate median scores for performance, accessibility, best-practices, and SEO categories.

What CLI tool runs Lighthouse against multiple URLs without an API key?▼

Unlighthouse is an MIT-licensed CLI that runs Lighthouse locally across multiple pages without requiring a PageSpeed Insights API key. It crawls a site, audits each route, and writes JSON and HTML reports to a configurable output directory.

Does Unlighthouse support desktop and mobile Lighthouse audits?▼

Yes, Unlighthouse supports both mobile and desktop form factors. Pass the desktop device flag to switch from the default mobile audit, allowing you to compare Core Web Vitals and category scores across different device profiles.

Why does Unlighthouse stop auditing before reaching my route limit?▼

Unlighthouse stops when the configured maximum routes cap is reached or when the overall subprocess timeout expires. The default per-page Lighthouse task timeout is 60 seconds, and the overall subprocess guard defaults to 600 seconds.

When should I use PageSpeed Insights instead of Unlighthouse?▼

Use PageSpeed Insights when you need single-URL field data from the Chrome UX Report or lab data for a specific page. Unlighthouse is better suited for site-wide lab audits, CI regression checks, and offline environments without API quota concerns.