168 infrasity-labs

seo-unlighthouse Skill

通过 MIT 开源的 Unlighthouse CLI 进行多页面 Lighthouse 审计。免费替代对站点每个 URL 逐个跑 PageSpeed 的方案——不消耗 API 配额,本地运行。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

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 | Mobile audit, up to 200 routes, JSON+HTML report in a temp dir |
| /seo unlighthouse --device desktop | Desktop form factor |
| /seo unlighthouse --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 /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).