Unlighthouse

CLI

调用 Google Lighthouse 自动扫描整个网站(同类页面智能抽样),在本地网页界面里逐页汇总 SEO、性能和无障碍评分;另有 unlighthouse-ci 命令直接生成报告,便于 agent 读取。适合市场人员给官网做 SEO 体检。需要 Node.js 22.18 或更高版本。

harlan-zw/unlighthouse4.9k
README

unlighthouse - Scan your entire website with Google Lighthouse.

Unlighthouse

npm version npm downloads License Skill repository on skilld.dev

Unlighthouse scans your entire site using Google Lighthouse,
with a modern UI, minimal config and smart sampling.

View Demo

Made possible by my Sponsor Program 💖
Follow me @harlan_zw 🐦 • Join Discord for help

Quick Setup

Run the following command:

npx unlighthouse --site <your-site>
# or PNPM
pnpm dlx unlighthouse --site <your-site>

[!TIP] Using an AI agent? Get the unlighthouse Skill on skilld.dev/gh/harlan-zw/unlighthouse.

Requirements: Node >= 22.18.0.

Getting Started

Install instructions for all integrations can be found on the docs site.

Need a hand? Join the Discord for one-on-one help.

gitignore

Unlighthouse will save your reports in outputDir, it's recommended you .gitignore these files.

.unlighthouse
Debugging

If you run into any issues with Unlighthouse, the first step should be to re-run the scan with debugging enabled.

# NPM
npx unlighthouse --site unlighthouse.dev --debug
# or PNPM
pnpm dlx unlighthouse --site unlighthouse.dev --debug

Docs

Integration instructions, Guides, API and config spec can be found on docs site.

Sponsors

Sponsors

License

Licensed under the MIT license.