mcpField
S
seo-unlighthouse

seo-unlighthouse

github.com/infrasity-labsTesting & quality15088 installsUpdated 17w ago
Repository

About seo-unlighthouse

seo-unlighthouse is a skill for running Lighthouse audits across a site's routes and aggregating the results. It supports site-wide checks, including local or CI measurements, with route limits and JSON and HTML reports.

Key features

  1. 01Audits multiple site routes
  2. 02Configurable route cap
  3. 03Mobile or desktop audits
  4. 04Aggregated scores and route breakdown
  5. 05JSON and HTML reports

Use cases

  1. 01Check site-wide regressions after deployment
  2. 02Measure local Core Web Vitals
  3. 03Audit more routes than an API quota allows

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill seo-unlighthouse

After installing, type/seo-unlighthousein Claude Code to confirm it loaded.

Details

From the project README

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

CommandEffect
/seo unlighthouse <url>Mobile audit, up to 200 routes, JSON+HTML report in a temp dir
/seo unlighthouse <url> --device desktopDesktop form factor
/seo unlighthouse <url> --max-routes 50 --output-dir ./reportsCap + 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.py workflow (Phase C).

Comments

Markdown supported