OpenParable
Skip to content
← Back to skills

SEO Unlighthouse

Testing & Quality
seo-unlighthouse

SEO Unlighthouse is an Agent Skill for testing & quality published in the AgriciDaniel/claude-seo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/AgriciDaniel/claude-seo/blob/HEAD/extensions/unlighthouse/skills/seo-unlighthouse/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/seo-unlighthouse, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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).