codebase-seo
監査、続いてGEOレビュー、そして修正の適用。Next.js / TypeScriptをデフォルトとしますが、リポジトリが既に使用しているものに従います。${CLAUDE_SKILL_DIR}はこのスキルのディレクトリです。作業ディレクトリはユーザーのプロジェクトですので、バンドルされたファイルはこのパスを通じて参照します。
| フラグ | フェーズ | コードの書き込み |
|---|---|---|
--audit | 1 — 技術的SEO | いいえ |
--geo | 2 — AI引用対応性 | いいえ |
--fix | 3 — コンテキスト内の調査結果を適用 | はい |
--full | 1 → 2 → 3 (デフォルト) | はい |
--routes /,/pricing でスコープを絞ります。デフォルトはすべてのルートです。
セットアップ
- ローカルパス と ライブURLの両方を優先します。それぞれが他方では検出できないものを捕捉します。
.agents/product-marketing.mdまたは.claude/product-marketing.mdが存在する場合は読み込みます。回答がない場合のみ質問します。--fixを使用するには、コンテキストにレポートが必要です。ない場合は--fullを実行します。
スクリプト
curl と Node 18+ が必要で、インストールは不要です。ソースコードを読む前にこれらを実行します。証拠を生成し、ソースコードの検査がそれを説明します。エラーレベルの発見がある場合、それぞれは非ゼロで終了します。Nodeスクリプトに --json を追加すると、構造化された出力が得られます。
bash "${CLAUDE_SKILL_DIR}/scripts/redirect-trace.sh" example.com /pricing /blog
node "${CLAUDE_SKILL_DIR}/scripts/extract-jsonld.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" https://example.com/pricing
node "${CLAUDE_SKILL_DIR}/scripts/audit-meta.mjs" out/pricing.html --base https://example.com
実際のルートを redirect-trace.sh に渡します。ループは / ではなく、深いパスで隠れていることがよくあります。
3つすべてのスクリプトは、サーバーサイドレンダリングされたHTMLのみを読み取ります。クライアントが注入したJSON-LDは、web_fetch と同様に、これらからは見えません。スクリプトの結果だけで「スキーマが見つかりません」と絶対に書かず、ブラウザで確認してください。
フェーズ1 — 技術監査 (--audit)
${CLAUDE_SKILL_DIR}/references/technical-audit.md を読み、そのチェックリストを実行します。最初にスクリプトを実行し、次にソースコードを使用して各発見事項を見つけ、説明します。
発見事項ごとに報告:
File: app/page.tsx:37-41
Severity: Critical | High | Medium | Low
Root cause: <1文>
Impact: <検索、ソーシャル、AI引用で何が壊れるか>
Fix: <最小限の変更、ファイル + 行>
Effort: <5分 | 30分 | プロダクト判断>
重大度でグループ化し、最後に表で締めくくります: # | 発見事項 | 重大度 | 工数 | リリースをブロックするか?
フェーズ2 — GEOレビュー (--geo)
${CLAUDE_SKILL_DIR}/references/geo.md を読みます。コピーするJSON-LD: ${CLAUDE_SKILL_DIR}/references/schema-recipes.md
最初にbotアクセスを確認します。クローラーがブロックされている場合、このフェーズの他のものは重要ではありません。
絶対に主張してはいけない2つのこと: スキーマタイプに「プリンストン大学の研究による」引用収益ランキングがあること(その研究はコンテンツ戦術をテストしたものであり、スキーマではありません)、および予測されるトラフィック増加。どちらもコードベースから観測可能ではなく、それらをでっち上げると実際の発見事項の信頼性を損なう。
出力は スキーマのギャップ、コンテンツの機会、アーキテクチャ上の決定 としてグループ化します。
フェーズ3 — 修正 (--fix)
フェーズ1とフェーズ2の発見事項を適用します。作業ツリーを編集して停止 — git add も git commit もしません。レビューとコミットはユーザーに属します。
- リポジトリのフレームワーク、ファイルレイアウト、スペルに合わせます。方言を押し付けないでください。
- 各編集の前に正確なファイルと行を指定します。最小限の変更で、ついでのリファクタリングや
anyは禁止です。 - スキーマフィールドを実際のデータソースに配線します。変動する値をハードコードしないでください。
aggregateRatingを決してでっち上げないでください。削除し、「実際のデータが必要」の下にリストします。- i18nアーキテクチャ、スキーマ説明以外のコピー、およびレポートがプロダクト入力を必要とするとマークしたものはスキップします。
ホストリダイレクト — 厳格なルール。 ホスティングプラットフォームが既に実行しているものをアプリレベルで複製する www↔apex、http↔https、または末尾スラッシュのリダイレクトは、ピンポン状態を引き起こし、ERR_TOO_MANY_REDIRECTS を生成し、サイトをダウンさせます。ホストの正規化はプラットフォームに任せます。ループを修正するには、アプリレベルのリダイレクトを 削除 することによって行い、決して別のリダイレクトを追加してはいけません。正規URLと実際に配信されるホストが単に一致しない場合は、メタデータを実際に提供されているホストに合わせるように変更します。メタデータに合わせるためのリダイレクトではありません。
バッチ1: フェーズ1からのすべてのCritical、High、Mediumの発見事項を重大度順に。 バッチ2: フェーズ2のスキーマ作業。
報告が完了する前に検証してください。 編集だけの強度で成功を主張しないでください。
- プロジェクトがビルドされること (
npm run build、またはリポジトリが使用するもの)。 extract-jsonld.mjsが、ビルドされたHTMLまたは開発サーバーに対してクリーンにlintされること。audit-meta.mjsが、変更されたすべてのルートで成功すること。- リダイレクトに触れた場合は
redirect-trace.shが成功すること。
実行できなかったステップとその理由を報告します。
出力セクション: 変更されたファイル (バッチごと)、検証、プロダクト判断が必要、実際のデータが必要。