lighthouse-audit 是一个技能,用于通过 Foghorn API 对网站运行 Lighthouse 审计并获取问题报告。Foghorn 是基于 Lighthouse 的站点健康监测服务:注册站点后,它会抓取 sitemap、审计每个页面,并通过 REST API 暴露结果。
主要能力:
- 注册团队与站点,触发 sitemap 抓取与页面审计。
- 查询 /issues 端点,按站点聚合所有已审计页面的审计失败项,可按 category 过滤:performance、accessibility、bestPractices、seo。
- issues 按受影响页面数排序(最普遍优先),每个 issue 内页面按 score 升序(最差优先),score 范围 0(失败)到 1(通过)。
- 通过 /pages 端点列出页面(可带 siteId、search 参数),并按 URL 或路径进行正则搜索。
使用方式(基于 curl 与 Bearer 令牌):
- 基础地址:https://foghorn-api.artgaard.workers.dev
- 先检查 ~/.foghorn 是否存有以 fh_ 开头的 API key;若无,则依次调用 /auth/sign-up、/auth/sign-in(返回 JWT)、/api-keys 创建 key,并将 key 写入 ~/.foghorn 以便复用。
- 首次使用需创建团队(POST /teams)与站点(POST /sites,需 teamId、domain,sitemapPath 默认为 /sitemap.xml)。
- 等待抓取:查询 GET /sites/:id,当 hasScrapedTheSitemap 为 true 表示 sitemap 已处理;再查 /pages?siteId=... 确认页面 lastAuditedAt 非空即完成审计。
- 查询问题示例:curl -s "https://foghorn-api.artgaard.workers.dev/issues?siteId=SITE_ID" -H "$AUTH";加 &category=accessibility 可按类别过滤。
适用场景:需要批量了解整站 Lighthouse 问题分布、定位最差页面与跨页面的普遍失败项。
限制:除 sign-up、sign-in、健康检查外,所有端点都需 Authorization: Bearer 令牌;审计依赖 Foghorn 周期性抓取,需等待 sitemap 处理与页面审计完成;本技能介绍未提供收费、价格、平台与效果承诺等信息。