seo-unlighthouse について
seo-unlighthouse は、サイト内の複数ルートで Lighthouse 監査を実行し、結果を集約するスキルです。ルート数を制限でき、ローカルや CI でのサイト全体の測定結果を JSON と HTML のレポートに出力します。
主な機能
- 01複数のサイトルートを監査
- 02ルート数の上限設定
- 03モバイルまたはデスクトップ監査
- 04集約スコアとルート別内訳
- 05JSON と HTML のレポート
活用シーン
- 01デプロイ後のサイト全体の回帰確認
- 02ローカルでの Core Web Vitals 測定
- 03API クォータを超えるルートの監査
インストール
コマンドをコピーしてターミナルで実行します。
$
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 の無料枠(QPD 25k)では足りない場合。
- オフライン/ローカルで 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のワークフロー(Phase C)を使用します。
コメント
Markdown 対応