资讯详情

claude-seo 的 Unlighthouse 扩展:零配额多页面 Lighthouse 审计的安装、路由与源码解析

📅 2026/10/26 9:49:09 | 华诺云谱 👁 阅读
claude-seo 的 Unlighthouse 扩展:零配额多页面 Lighthouse 审计的安装、路由与源码解析
【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载Unlighthouse 是一个 MIT 许可的多页面 Lighthouse 运行器能够对整站所有 URL 逐一执行 Lighthouse 审计并汇总为单一聚合报告不需要 API 配额、不需要任何凭据除了爬取目标站点外也没有额外网络外发。本文基于 claude-seo 仓库中 extensions/unlighthouse/docs/UNLIGHTHOUSE-SETUP.md 展开完整讲解该扩展的安装、验证、卸载流程/seo unlighthouse命令的路由规则与全部参数并深入 scripts/unlighthouse_run.py 的源码实现说明其 SSRF 安全前检、Node 环境检查、超时管理与结果解析机制。读完本文你将掌握如何在本地、离线或 CI 环境中对整站进行免费的全量 Core Web VitalsCWV实验室测量并能在 Unlighthouse 与 PageSpeed Insights 之间做出正确选型。为什么需要 Unlighthouse单 URL 审计之外的整站方案PageSpeed InsightsPSI免费配额约 25,000 QPD对于大型站点往往不够用而逐 URL 调用 PSI API 的聚合工作流在没有付费 Google Cloud 账单的情况下几乎不可行。Unlighthouse 恰好填补了这一空白它在本机运行 Lighthouse 实验室测试通过爬取站点收集全部或设定上限的路由输出一份聚合报告。从 scripts/unlighthouse_run.py 的模块文档可以确认其定位它是对站点每个 URL 运行 PageSpeed 并聚合结果这一工作流的最接近的免费等价物。同时Unlighthouse 是本地运行的因此在离线或受限环境如无法访问外部 API 的 CI 网络中依然可用。该扩展属于 claude-seo 的 extension 体系安装脚本将seo-unlighthouse技能复制进~/.claude/skills/使 Claude Code 可以通过/seo unlighthouse命令直接调度底层由统一的 scripts/unlighthouse_run.py 封装器驱动。安装两条命令、三个步骤、零凭据安装命令在仓库根目录执行以下任一脚本即可bash 与 PowerShell 二选一./extensions/unlighthouse/install.sh.\extensions\unlighthouse\install.ps1安装器做了什么对照 install.sh 与 install.ps1 的源码安装流程共三步校验环境检查 Python 3 与 Node 18npx是否在$PATH上同时确认~/.claude/skills/seo已存在——也就是说必须先安装 claude-seo 基础技能Unlighthouse 扩展才能安装成功。两个安装器对任一前置条件缺失都会立即报错退出。预热 Unlighthouse通过npx --yes --packageunlighthouse0.13.5 unlighthouse-ci --help把固定版本的unlighthouse0.13.5下载到 npx 缓存之后的每次运行都直接命中缓存不再重复下载。复制技能文件将extensions/unlighthouse/skills/seo-unlighthouse/SKILL.md复制为~/.claude/skills/seo-unlighthouse/SKILL.md让 Claude Code 能够发现并路由/seo unlighthouse命令。整个安装过程不需要任何 API Key也不会修改 settings.json。卸载时运行 uninstall.sh它只删除技能目录并特别注明没有任何需要从 settings.json 移除的内容——Unlighthouse 没有密钥。版本固定值得注意封装器与安装器都将 Unlighthouse 钉死在unlighthouse0.13.5见 scripts/unlighthouse_run.py保证 CI 或本机多次运行的行为可复现。验证安装与命令路由安装完成后用一条最小命令验证/seo unlighthouse https://example.com --max-routes 5技能的路由规则定义在 extensions/unlighthouse/skills/seo-unlighthouse/SKILL.md 中汇总如下命令效果/seo unlighthouse url移动端审计最多 200 条路由JSONHTML 报告输出到临时目录/seo unlighthouse url --device desktop桌面端形态form factor/seo unlighthouse url --max-routes 50 --output-dir ./reports设置爬取上限并持久化报告目录所有旗标flag都会转发给scripts/unlighthouse_run.py由它统一处理 url_safety 安全前检与子进程超时管理见下一节。--max-routes通过--scanner参数以 JSON 形式传入{maxRoutes: N}即控制 Unlighthouse 爬虫最多审计的路由数量避免对超大站点产生不可控的审计时长。封装器源码解析安全前检、Node 检查、超时与结果调用入口与命令行参数unlighthouse_run.py是一个薄封装CLI 参数如下scripts/unlighthouse_run.py参数默认值说明target位置参数必填待爬取审计的站点 URL--devicemobilemobile或desktop控制 Lighthouse 形态因子--max-routes200爬取路由数量上限--output-dir临时目录HTML/JSON 报告的持久化目录--timeout600子进程超时秒数--json关闭以 JSON 形式输出完整结果对象直接命令行调用示例python scripts/unlighthouse_run.py https://example.com python scripts/unlighthouse_run.py https://example.com --json python scripts/unlighthouse_run.py https://example.com --device desktop --max-routes 50SSRF 安全前检在启动任何子进程之前封装器会调用validate_url_strict(target)scripts/unlighthouse_run.py。这一步来自仓库的统一安全模块 scripts/url_safety.pyvalidate_url_strict会执行 DNS 解析检查每一个返回的 A 记录是否都是公网地址任何私有、回环、保留、链路本地或多播地址都会抛出URLSafetyError从而同时阻断 SSRF 与 DNS rebinding 攻击。测试 tests/test_technical_depth.py 用http://192.168.1.1/验证了这一行为私有 IP 目标会被直接拒绝并返回{ok: False, error: url_safety: ...}。Node 环境检查安全校验通过后封装器通过shutil.which(npx)检查 Node 是否可用scripts/unlighthouse_run.py找不到npx时返回错误并提示安装 Node.js 18。对应的测试 tests/test_technical_depth.py 通过 monkeypatch 模拟npx缺失确认返回错误路径而非抛出异常。实际命令构造与超时管理无--output-dir时使用tempfile.mkdtemp(prefixclaude-seo-unlighthouse-)创建临时输出目录。随后构造子进程命令scripts/unlighthouse_run.pynpx --yes --package unlighthouse0.13.5 unlighthouse-ci \ --site target \ --device mobile|desktop \ --output-path out_dir \ --build-static-files \ [--scanner {maxRoutes: N}]子进程以 600 秒可调超时运行超时返回{ok: False, error: ...timed out after 600s, output_dir: ...}——注意输出目录会被保留便于排查半成品结果FileNotFoundError也被单独捕获并返回可读错误。结果解析与输出封装器从输出目录读取 Unlighthouse 写入的ci-result.jsonscripts/unlighthouse_run.py解析后返回结构化结果。返回对象包含ok/exit_code子进程是否成功target规范化后的目标 URLoutput_dir报告目录绝对路径summaryci-result.json的完整内容stdout_tail/stderr_tail子进程输出的末尾 2000 字符便于排查失败原因。技能文档extensions/unlighthouse/skills/seo-unlighthouse/SKILL.md明确说明了聚合字段的语义score.performance为所有审计路由的中位数另有score.accessibility、score.bestPractices、score.seo逐路由明细可查output_dir/ci-result.json。非--json模式下CLI 会把scores或score字段逐个打印成键 值形式便于人读。Unlighthouse 与 PageSpeed Insights如何选型原文档给出的选型对照表是理解二者定位的核心完整保留如下使用 Unlighthouse使用 PSI站点有数百个页面希望全部被审计单 URL 聚焦审计离线 / 受限环境真实 Chrome 用户的字段数据CrUX部署后的 CI 驱动回归检查快速 CLI / 网页表单检查免费 / 无配额顾虑小站点配额足够时用 PSI一个必须牢记的差异PSI 在可用时使用 CrUX 字段数据真实用户Unlighthouse 在本地运行 Lighthouse 实验室测试。因此若要衡量生产流量的可信 Core Web Vitals应优先选择 PSI / CrUX。Unlighthouse 的价值在于覆盖面与成本当你的目标是整站几百个页面全部测一遍且不想消耗 API 配额时本地聚合是更合适的手段。卸载./extensions/unlighthouse/uninstall.sh卸载器只删除~/.claude/skills/seo-unlighthouse目录不触碰 settings.json。由于 Unlighthouse 全程无密钥卸载是干净彻底的。与仓库其他技能的配合技能文档给出了两条跨技能协作路径方便在实战中组合使用需要单 URL 的字段数据CrUX改用seo-google psi/seo-google crux它们走 Google 官方 API 获取真实用户数据慢页面 LCP 子部分拆解使用scripts/lcp_subparts.py工作流Phase C对 Unlighthouse 发现的性能瓶颈页面做更细粒度的 LCP 归因分析。此外CLAUDE.md 的脚本索引CLAUDE.md将该脚本标注为Unlighthouse CLI wrapper (site-wide Lighthouse)并归入技术 SEO 脚本组。整体上Unlighthouse 扩展在 claude-seo 中扮演整站性能基线角色跑一遍得到全站聚合分数与逐路由明细再对有问题的页面下钻到 PSI/CrUX 字段数据或 LCP 子部分分析形成从实验室基线到字段验证的完整 CWV 工作闭环。赞分享【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载相关推荐claude-seo 的 seo-unlighthouse 技能用 Unlighthouse CLI 实现全站多页面 Lighthouse 审计与 CWV 回归检测claude seo 的 seo unlighthouse 技能用 Unlighthouse CLI 实现全站多页面 Lighthouse 审计与 CWV 回ShopXO 中的 ThinkPHP 页面 Trace 调试think-trace 扩展安装、配置与源码解析ShopXO 中的 ThinkPHP 页面 Trace 调试think trace 扩展安装、配置与源码解析 导读 本文聚焦 ThinkPHP 6 官方调试电商后端企业应用CMSclaude-seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南claude seo 的 SEO 图片分析 Agent基于 banana 扩展的 OG 图审计与生成计划实战指南 本指南以 claude seo 仓库中 ba上一篇Django REST Framework SimpleJWT 使用指南轻量级JWT认证解决方案下一篇Bottender项目Slack机器人接入完整指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑