seo-geo-audit は何をしますか?
フロントエンドリポジトリを古典的SEO(Googleクローラーが気にする要素)とGEO(生成エンジン最適化:LLMがコンテンツを読む際に気にする要素)の両方で監査します。重要度、ファイル:行の引用、具体的な修正案を含むマークダウンのレポートカードを出力します。
革新的な価値はGEOにあります。古典的SEOスキャナーは長年存在してきました。しかし、「あなたのサイトは言語モデルにとって抽出、引用、推論が容易か?」という問いに本当に答えられるのは、Claude自身が消費者だからこそ、Claudeだけです。
呼び出し方
| トリガー | 動作 |
|---|---|
/audit または /seo-geo または /seo-geo-audit | 標準監査:SEO + GEO、ルートレベル+主要ルート、最大約30ファイル |
/audit deep | リポジトリ内で発見可能なすべてのルート/ページを巡回。より遅いが、より徹底的 |
/audit seo | 古典的SEOのみ |
/audit geo | GEOのみ |
/audit fix | 監査後、高重要度の各指摘に対して具体的なファイル編集を提案(編集前に確認) |
/audit report.md | インライン表示ではなく、レポートをファイルに書き出す |
| 自然言語:「このサイトをSEO監査して」「これはLLMフレンドリーですか」「構造化データをチェックして」 | 同上 |
停止/無効化
セッションベースではありません。一回限りの実行です。呼び出さなければ何も起こりません。
実行フロー
- フレームワークの検出:
package.jsonを読み取ります。next、astro、nuxt、svelte-kit、remix、gatsby、vite、vueを探すか、プレーンHTMLにフォールバックします。フレームワークによって、ファイルグロブとページの配置場所(pages/、app/、src/routes/、src/pages/、content/など)が決まります。 - コンテンツソースの発見:
scripts/discover.sh <framework>を介して行います。 <head>コンテンツと構造化データの抽出:scripts/extract-head.shとscripts/find-jsonld.shを介して行います。JSX/TSXの場合は、<Head>、<Helmet>、<Metadata>、またはフレームワーク固有のパターン(Next.js のmetadataエクスポート、Astro のフロントマター、Nuxt のuseHead)を探します。- チェックの実行:
checks/seo.mdとchecks/geo.mdの各チェックは、抽出データに対するClaude の推論の一部です。正規表現ではありません。これがポイントです。古典的スキャナーはメタタグが存在することを教えられますが、説明文が良いかどうかを判断できるのはClaudeだけです。 - カテゴリごとのスコアリング:
checks/scoring.mdを使用します。カテゴリごとに文字グレード+数値スコアを付与します。 - レポートのレンダリング:
templates/report-card.mdから、ファイル:行の引用、重要度、修正提案を含む指摘を埋め込んで生成します。 fixモードの場合:高重要度の各指摘に対して、標準のプレビュー→適用パターンで具体的な編集を提案します。ユーザーの確認なしに適用することはありません。
スキル間連携
llms-txt スキルがインストールされている場合、GEOの指摘に「llms.txt がない」が含まれているとき、そのスキルの実行を推奨します。a11y-audit スキルが存在する場合、すべてのレポートの下部に「この監査はSEOとGEOをカバーしています。アクセシビリティについては /a11y-audit を実行してください。」と表示します。
安全性ガードレール
- デフォルトでは読み取り専用。
fixモードのみ編集を提案し、すべての編集には確認が必要です。 - ライブサイトを取得しない。 ソースリポジトリを監査します。ライブサイト監査はLighthouse / PageSpeedの領域です。別のツール、別の関心事です。
- フレームワークの規約を前提としない。 最初に
package.jsonを確認します。pages/フォルダは、Next、Nuxt、Gatsby、バニラで意味が異なります。 - ポリシーファイルを決して変更しない(
robots.txt、noaiメタタグ、llms.txt)— これらは技術的な決定ではなく、ステークホルダーの決定です。 - 生成物/ビルド成果物をスキップする。
dist/、build/、.next/、out/、.nuxt/は監査しません。ソースを監査します。 - ディープ監査に上限を設ける。
deepモードでも、--no-limitの確認なしに約500ファイルを超えるスキャンを拒否します。
このスキルのファイル
SKILL.md— このファイルchecks/seo.md— 重要度付きの古典的SEOチェックリストchecks/geo.md— GEOチェックリスト(革新的なチェック)checks/scoring.md— 指摘をカテゴリごとに0–100のグレードにマッピングする方法templates/report-card.md— 最終レポート用のマークダウンテンプレートscripts/discover.sh— フレームワーク別にフロントエンドソースファイルを検出scripts/extract-head.sh— HTML/JSX/MDXから<head>コンテンツを抽出scripts/find-jsonld.sh—<script type="application/ld+json">ブロックを抽出scripts/check-llms-txt.sh— リポジトリに llms.txt があるか確認examples/good-site-report.md— 最適化されたサイトのレポート例examples/bad-site-report.md— 典型的なグリーンフィールドサイトのレポート例