何をチェックするか
site_audit は静的ビルド成果物（Astro dist/、Next.js out/、Hugo public/——HTML ファイルを含むディレクトリ全般）をスキャンし、4 グループに分けて問題を報告します：
技術 SEO
- 孤立ページ（sitemap にあるが内部リンクがゼロ）
- 内部リンク切れとスラッシュ不足による 301
- タイトルと meta description の欠落・重複・長さ異常
- H1 欠落、H1 複数、見出し階層スキップ（H1→H3）
- canonical 競合、 oversized 画像、alt・サイズ属性の欠落
- robots.txt の sitemap 宣言、Open Graph、viewport、html lang、favicon
GEO / AI 可視性
- llms.txt と llms-full.txt の存在と深さ
- Q&A コンテンツの FAQPage/HowTo schema 欠落、商用ページの Product/Offer schema 欠落
- robots.txt のコンテンツシグナル（ai-input / search）
- BLUF（結論先行）検出、コンテンツ構造（H2、リスト、テーブル）
- クロール阻断（コンテンツページの noindex、robots 全拒否）
エージェント対応（v1.4.4）
- llms.txt に When to use セクション必須——なければエージェントはサイトの用途を判断できない
- llms.txt に how-to-call 行（インストールコマンド / エンドポイント / MCP エントリ）が必要
i18n とパフォーマンス
- hreflang 交互リンクと x-default フォールバック
- ページサイズ（クロールバジェット）、staging サブドメイン漏えい、sitemap URL インベントリ、JSON-LD フィールド検証
使い方
# 基本——ビルド出力と sitemap を指定
python3 -m zens_ink.site_audit --dist dist --sitemap dist/sitemap.xml
# CI 用 JSON レポート
python3 -m zens_ink.site_audit --dist dist --sitemap dist/sitemap.xml --format json --output audit.json
# 特定言語サブツリーのみ監査
python3 -m zens_ink.site_audit --dist dist --sitemap dist/sitemap.xml --base /jaレポートの読み方
問題はタイプ別にグループ化され、重大度（error / warning / info）と対象パスが付きます。各グループの末尾に修正ヒント。サマリー行は重複除去後の問題数を表示します。
依存ゼロ —— 純 Python 標準ライブラリ。任意のビルド成果物をオフラインで解析。API キー不要、ライブサイトのクロールなし。
CI 統合
エラーが閾値を超えたらビルドを失敗させる：
python3 -m zens_ink.site_audit --dist dist --sitemap dist/sitemap.xml --format json --output audit.json
python3 -c "
import json
r = json.load(open('audit.json'))
errors = [i for i in r['issues'] if i['severity'] == 'error']
exit(1 if len(errors) > 0 else 0)
"