AIOGeoScanが見ている診断ロジック、サイト全体を横断して課題を特定する考え方、そして診断後に得られるアウトプットやAI改善指示書の使い方までを、実務目線で一気通貫に整理しています。
サイト規模が大きくなるほど、手動の動作確認は「事故の温床」となり、生産性を著しく阻害します。
AIOGeoScanは、ページ単位の問題を数えるだけの監査ツールではありません。
ソースコードはAI開発ツールが、そして**デプロイ後の現実はAIOGeoScanが把握**します。 両者の情報を繋ぐことで「エンジニアの意図が正しく世界に伝わっているか」を網羅検証する、QA兼マーケティング基盤です。
だからAIOGeoScanは、単なる監査ツールではなく、サイト全体の改善方針と「どこから着手すべきか」の判断を加速させるための解析基盤として機能します。 この考え方をもとに、次のセクションでは診断内容を10カテゴリで整理して公開しています。
「6つのスコア項目」と「4つの独立診断」を分けて見せるのではなく、公開している主要診断テーマを最初から 10 カテゴリで統一。 まず全体像を見て、気になるカテゴリだけを深掘りできる構成にしています。
検索結果やSNSカード、AIエージェントの理解を助けるメタ情報をバリデートします。
<html lang="ja"> の存在を確認。AIクローラーが言語を自動判定できない状態を検知。
titleタグの存在と文字数(20〜65文字が目安)を検証。
meta description の存在と文字数(50〜170文字が目安)を検証。
Open Graph タイトルの設定有無を確認。SNS シェア時の表示に影響。
Open Graph 概要文の設定有無を確認。
OGP 画像の設定有無を確認。SNS でのリンクカード表示に必須。
サイト名の OGP 設定を確認。
コンテンツ種別(website / article など)の設定を確認。
twitter:card・twitter:image の設定を個別に検証。X / Twitter での表示品質を確保。
AIOGeoScanは、診断結果を並べて終わるツールではありません。サイト全体の状態把握から、 優先順位の決定、修正の実行、チーム共有まで、次の一手が見える形でアウトプットします。
これらの詳細な診断データをもとに、AI改善指示書の作成や実務データのエクスポートが可能になります。
PHASE 03で出力されるAI改善指示書は、読むためのレポートではありません。 AI支援ツールに渡し、修正案の作成から実装、再確認までをスムーズに進めるための実務フォーマットです。
Markdown形式のAI改善指示書をコピーします。課題ID付きなので、どの問題を直したいかをそのままAI開発エージェントに伝えられます。
GitHub Copilot, Cursor, Claude Code などに貼り付けて、対象課題の修正案を即座に生成させます。指示書を渡すだけでコンテキストが同期されます。
生成された修正案を確認し、必要に応じて調整したうえでコードやCMS設定へ反映します。最終判断は常に人が持てる設計です。
修正後にもう一度スキャンし、課題が解消されたかを確認します。残課題も追えるため、継続的な改善サイクルを回せます。
AI改善指示書(Markdown)には、AIエージェントを制御するための3つの厳格な命令が最初から組み込まれています。
AIに対し「このレポートは外部スキャンによる『仮説』であり、ソースコードを直接見た結果ではない」と自覚させ、勝手な推測でコードを断定することを防ぎます。
レポート内の課題ID(UNI-001等)を用いて、開発者と修正の必要性や優先度を議論することを義務付けます。AIの「即・修正」ではなく、文脈の理解を優先させます。
「ユーザーと意図が100%一致するまで、絶対にファイルを編集してはならない」という強い制約を課します。これにより、意図しないコードの書き換え事故を未然に防ぎます。
AIOGeoScanはHTTPレスポンスとレンダリング後のDOMを解析しますが、構造上の制約があります。これらを知っておくことで、診断結果をより正確に読み解けます。
Suspense の内側にある 'use client' コンポーネントが hydration 完了前に解析されると、H1 や構造化データが「欠落」と誤判定される場合があります。レンダリング方式が「Streaming」と表示されているページでは、見出し・階層の判定を参考値として扱ってください。
React / Vue / Angular などのクライアントサイドレンダリングでは、Puppeteer が利用できない環境(本番サーバー等)の場合、JS 実行前の素の HTML を解析します。その場合メタ情報・見出し・JSON-LD のすべてが空になる可能性があり、レンダリング方式欄に「CSR」と表示されます。
ロゴ画像を H1 でラップするパターン(業界標準)は、alt 属性のテキストを見出し本文として取得します。alt が空の場合は「H1 テキストなし」と表示されますが、H1 自体は存在しているため「欠落」エラーにはなりません。
サイトマップに /book/1, /book/2 ... が含まれていても、/book/ というインデックスページが存在しない場合があります。ディレクトリ名(/book/)はあくまで URL のグループラベルであり、その URL 自体を診断するわけではありません。404 を返した URL は診断結果に「HTTPステータス: 404エラー」として表示されます。
AIOGeoScan は各 URL に直接アクセスしてスキャンします。SPA のルーター経由でのみ到達できるページ(直接 URL アクセスで内容が異なる場合)は、実際のユーザー体験と異なる結果になることがあります。
ソースコードが正しくても、SSR のレンダリング処理、CDN(Cloudflare 等)のキャッシュ、ビルド時の最適化(メタ情報の最小化や除去)によって、実際の配信内容が異なる場合があります。診断ツールは「ユーザーが受け取っている最終的な HTML」を解析するため、開発環境では正しくても本番でエラーが出る場合は、配信設定やキャッシュをご確認ください。
【そのまま修正してよい】title・description の文字数、OGP 画像の欠落、JSON-LD の構文エラー、noindex の誤設定。 【コードを確認してから判断】見出し階層のスキップ、H1 欠落、Canonical の不一致(特に Streaming ページ)。Next.js の metadataBase 仕様やストリーミング構造を理解した上で判断してください。
診断結果に「エラー」「警告」が出たときは、まずコードを直接確認してください。 特にレンダリング方式が Streaming / CSR のページでは、見出し構造・H1・Canonical の指摘は「コード照合なしで修正しない」ことを推奨します。 一方、Static / SSR のページでの title・description・OGP・JSON-LD の指摘は信頼性が高く、コード確認なしで対応を始めて問題ありません。