SEO Quick Audit (Lite)
ユーザーが提供するローカルHTMLファイルに対して scripts/audit.mjs を実行し、コアなページ内SEOチェックの pass/warn/fail を報告します。完全オフライン — スクリプトは1ファイルを読み込み、JSONを出力します。
スコープとルール
- ユーザーが提供したファイルのみ監査します。このライト版はURL、robots.txt、sitemap.xmlをフェッチしません — 報告時にはその旨を伝えてください。
- pass/fail は一般的な慣習に基づいており、検索エンジンの保証ではありません。
- ファイルを変更しないでください。読み取り専用です。
1. 実行
Node 18以上が必要で、依存関係はありません。
node <skill-dir>/scripts/audit.mjs page.html
標準出力にJSON；warn/failが存在する場合は終了コード 1（CIゲート可能）、読み取り/使用エラーの場合は 2 を返します。
2. レポートの読み方
summary: pass/warn/fail/info のカウント。checks[]:{id, status, detail}の形式で、以下の項目を含む:title、meta-description、canonical、robots-meta、viewport、open-graph、h1、img-alt、lang、charset。
3. 修正ガイダンス
title/meta-descriptionが warn → 30～65文字 / 50～160文字に書き直します。- ランキング対象のページで
robots-meta: noindex→ ディレクティブを削除します。 canonicalがない →<link rel="canonical">を追加します。h1が fail → ページに正確に1つの説明的なh1を配置します。open-graphが warn → リンクプレビューのために og:title、og:description、og:image を追加します。
Lite版とフル版の違い
フル版の seo-quick-audit はさらに、ライブURLのフェッチ（/robots.txt や /sitemap.xml のステータス）、twitter-cardチェック、リダイレクト処理を行います。