監査

blume audit はビルド済みのサイトをクロールし、SEO とサイトの健全性に関する問題を報告します。各指摘には、修正箇所となるソースファイルとフロントマターの行が示されます。

blume validate は コンテンツ を読み取りますが、blume audit は ビルド済みのサイト を読み取ります。ビルド後に dist/ 内の HTML をクロールし、SEO とサイトの健全性に関する問題を報告します。対象は、タイトル、メタディスクリプション、canonical、Open Graph と X のカード、見出し、hreflang、画像、サイトマップ、robots.txt、構造化データです。

サイトをビルドしたのは Blume なので、各指摘にはクローラーから見える URL だけでなく、修正すべきソースファイル とフロントマターの行 も示されます。

⚠ Meta description too long or too short   5 pages
    /docs/configuration/export    content/docs/configuration/export.mdx:3
    fix: Rewrite `description` in the frontmatter to fit the length range.

ビルド後に実行します。

blume build
blume audit

指摘はページごとに並ぶのではなく、チェックごとにまとめて表示されます。そのため、レポートは ToDo リストのように読めます。--verbose を使うと影響を受けるすべてのページを詳細付きで展開できます。--only/--skip を使うと、1 カテゴリずつ対処できます。blume audit --list-checks はチェックの全カタログを出力します。内容はこのページ末尾のチェックカタログと同じで、各指摘の docsUrl はそのカタログ内の該当項目にリンクしています。

フラグ

--fail-on error|warning|info — CI のゲートです。この重大度以上の指摘があると、0 以外の終了コードで終了します。デフォルトは error です。--strict は --fail-on warning のエイリアスです。
--url <origin> — 稼働中のデプロイにもリクエストを送り、ステータスコード、レスポンスヘッダー、リダイレクトチェーンを確認します。
--external — 外部リンクをネットワーク経由で確認します。
--only <check|category> / --skip <check|category> — レポートの対象を指定したチェックやカテゴリだけに絞り込むか、それらを除外します（カンマ区切り）。どのチェックにもカテゴリにも当てはまらない語を指定するとエラーになり、最も近い候補が提案されます。そのため、タイプミスでレポートが気づかないうちに空になることはありません。
--list-checks — 監査が報告できるすべてのチェックを出力して終了します。
--verbose — 最初の数件だけでなく、影響を受けるすべてのページを各指摘の詳細とともに一覧表示します。
--json — レポートを JSON として標準出力に出力します。
--claude / --codex — 指摘を Claude Code または Codex に渡し、対話形式で修正させます。

CI を失敗させる

基準になるのは終了コードです。デフォルトでは、blume audit はエラーがあるときだけ失敗します。エラーとは、ビルドされていないページへのリンク、リダイレクトループ、無効なサイトマップなど、確実に壊れているものです。改善を勧めるだけの指摘（短すぎる description、タイトルの重複など）は警告として扱われ、ビルドは失敗しません。

blume audit                      # fails on errors
blume audit --fail-on warning    # also fails on warnings

稼働中のデプロイを確認する

実際のサーバーでしか確認できないこともあります。たとえば、dist/ にあるページが誤ったリライトのせいで実際には 404 になっていないか、レスポンスが圧縮されているか、といった点です。HTML には問題がないのに、X-Robots-Tag ヘッダーのせいで気づかないうちにインデックスから外れていないかも、サーバーでしか確認できません。これらのチェックを追加するには、監査の対象にデプロイを指定します。

blume audit --url https://docs.example.com
blume audit --url https://docs.example.com --external   # also probe outbound links

外部リンクは一律に失敗扱いにはせず、状況に応じて評価します。404 は修正できるリンク切れです。一方、403 や 5xx はたいていレート制限か相手側の障害なので、警告として報告します。

エージェントで指摘を修正する

Claude Code や Codex を使っている場合は、監査の指摘をそのまま渡せます。

blume audit --claude   # or --codex

このコマンドは完全な JSON レポートをファイルに書き出します。ターミナルに表示される 3 ページ分のプレビューではなく、影響を受けるすべてのページが含まれます。続いて、指摘を順に処理させるプロンプトとともにエージェントを対話モードで起動します。エージェントは、各指摘が示すソースファイルを編集して提案どおりに修正し、レポートがクリーンになるまで blume build と blume audit を再実行します。このセッションは意図的に対話型にしています。編集内容はエージェント自身の権限フローで確認できます。また、コンテンツを削除して指摘を解消しないよう、エージェントに指示しています。

--only と --skip は、レポートと同じように、エージェントに渡す内容も絞り込みます。そのため、1 カテゴリずつ渡すこともできます。

チェックする項目としない項目

チェックの範囲は、汎用の SEO クローラーより意図的に狭くしています。汎用クローラーが報告する項目の多くは、Blume のサイトでは発生しません。Blume は rel=nofollow を出力しませんし、Vite のコンテンツハッシュ付きバンドルが欠けたりリダイレクトしたりすることもありません。こうした項目を毎回ゼロ件と報告しても、レポートを読み飛ばす習慣がつくだけです。

次の 2 つの制限は明記しておきます。

構造化データ は、形式が正しいかどうか（有効な JSON であること、@context があること、すべてのノードに @type があること）だけを検証します。schema.org の語彙全体や Google のリッチリザルトのルールに照らした検証は行いません。
Core Web Vitals はチェックしません。計測には実際のブラウザが必要です。実は何も計測しないフラグを用意するくらいなら、フラグがないほうがましです。そのため blume audit は、オフラインで確認 できる レイアウトシフトの原因（width/height のない画像、サイズが大きすぎるアセット）だけを報告し、それ以外は現時点では対象外にしています。

監査で実行されなかったチェックは、合格扱いにはせず、スキップとして報告します。

⊘ network      skipped — pass --url <origin> (11 checks)
⊘ external     skipped — pass --external (2 checks)