mcpField
S
seo-unlighthouse

seo-unlighthouse

github.com/infrasity-labs测试与质量15088 次安装17 周前更新
代码仓库

关于 seo-unlighthouse

seo-unlighthouse 是一项针对网站多个路由运行 Lighthouse 审计并汇总结果的技能。它支持本地或 CI 全站检查，可设置路由数量上限，并生成 JSON 和 HTML 报告。

主要功能

  1. 01审计网站多个路由
  2. 02可配置路由数量上限
  3. 03移动端或桌面端审计
  4. 04汇总评分及路由明细
  5. 05生成 JSON 和 HTML 报告

适用场景

  1. 01部署后检查全站回归
  2. 02测量本地 Core Web Vitals
  3. 03审计超出 API 配额的更多路由

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/seo-unlighthouse确认已加载。

详细介绍

seo-unlighthouse

对网站上的每个 URL 运行 Lighthouse（数量上限可配置）， 并汇总结果。适用于以下情况：

  • PageSpeed Insights 的免费配额（25k QPD）不足以覆盖大型网站。
  • 你想离线 / 本地测量 CWV（集成到 CI 中、在受限环境中运行）。
  • 部署后需要快速检查全站回归。

先决条件

  • 运行 extensions/unlighthouse/install.sh（无需 API 密钥）。
  • $PATH 中有 Node 18+。

路由

命令效果
/seo unlighthouse <url>移动设备审计，最多 200 个路由，在临时目录中生成 JSON+HTML 报告
/seo unlighthouse <url> --device desktop桌面设备规格
/seo unlighthouse <url> --max-routes 50 --output-dir ./reports限制数量并持久保存

所有标志都会传递给 scripts/unlighthouse_run.py，由它处理 url_safety 预检和子进程超时管理。

输出处理

包装器会从 Unlighthouse 输出目录读取 ci-result.json 并 解析后返回。汇总字段：

  • score.performance（已审计路由的中位数）
  • score.accessibility、score.bestPractices、score.seo
  • 各路由的细分结果见 <output_dir>/ci-result.json

跨技能委派

  • 对于单个 URL 的现场数据（CrUX），使用 seo-google psi / seo-google crux。
  • 对于加载缓慢页面的 LCP 子部分分解，使用 scripts/lcp_subparts.py 工作流（阶段 C）。

评论

支持 Markdown