seo-unlighthouse
Multi-page Lighthouse audit via the MIT-licensed Unlighthouse CLI. Free-tier alternative to running PageSpeed against every URL on a site — no API quota burn, runs locally.
How do I install this agent skill?
npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill seo-unlighthouseIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a multi-page SEO auditing tool using the Unlighthouse CLI. It features a built-in safety pre-flight check for target URLs and executes Lighthouse audits locally, minimizing API usage.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
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.pyworkflow (Phase C).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/infrasity-labs/dev-gtm-claude-skills/seo-unlighthouse">View seo-unlighthouse on skillZs</a>