CodexのテクニカルSEOワークフロー：診断、diff作成、テスト、人間の承認を経てから本番変更へ進む。
ルール：Codexはファイルを編集できるので、あえて遅く進める
テクニカルSEOでは、Codexは非常に役立ちます。同時に、本当に危険にもなります。Codexはコードを調べ、修正を生成し、テストを実行し、diffを用意できます。だからこそ、本番環境で「technical SEOを直して」と頼んではいけません。まず診断、チケット作成、パッチ案、検証、承認待ちの順番で進めます。
テンプレート、schema、sitemap生成、robotsルール、redirect、canonical、内部リンクコンポーネント、レンダリングされたmetadataに関わる問題では、CodexをテクニカルSEOに使えます。ただし、書き換えより先に証拠とリスクを出させます。
テクニカルSEOでは、Codexの設定、承認、検証コマンドが、本番向けファイルを触る前の安全装置になります。
まずは診断だけを依頼する
最初のプロンプトは、編集禁止にします。
Run a technical SEO/GEO diagnosis for these URLs and files.
Do not edit anything yet.
Check crawlability, robots rules, noindex, canonical, sitemap presence, schema, rendered headings, FAQ visibility, and internal links.
Return evidence, affected files, risk level, and validation steps.
この段階でほしいのは、修正ではありません。何が問題で、どのファイルが関係し、どのくらい危険で、どう検証するかです。初心者ほど、先に「直す」よりも「証拠を集める」ほうが安全です。
テクニカル監査マップ
| レイヤー | Codexが確認すること | 証拠 | 担当 |
|---|---|---|---|
| クロールアクセス | robots、status code、blocked path | ファイル + request結果 | SEO + engineering |
| インデックス信号 | noindex、canonical、sitemap | render/source の証拠 | engineering |
| レンダリング後ページ | heading、link、visible copy | browser/test 出力 | frontend |
| 構造化データ | schemaの有無と整合性 | validator/test 出力 | engineering |
| GEO抽出 | answer block、definition、FAQ | ページセクションの証拠 | content + SEO |
この表を seo/reports/technical-audit-map.md として保存しておくと、次回以降の監査でも同じ観点で確認できます。
パッチの前にパッチ計画を依頼する
診断で問題が見つかっても、すぐに編集させません。次に、パッチ計画だけを作らせます。
Create a technical SEO patch plan.
For each proposed change, include:
- file path
- exact issue
- why it matters
- risk level
- test command
- rollback plan
Do not edit files until I approve the plan.
パッチ計画では、ファイルパス、問題、重要性、リスク、テストコマンド、ロールバック方法がそろっている必要があります。これが書けない修正は、初心者がCodexに任せるにはまだ危険です。
安全なパッチワークフロー
- 問題を診断する。
- パッチ計画を作る。
- 人間の承認を得る。
- 最小のdiffだけ適用する。
- テストとローカルチェックを実行する。
- レビューメモを作る。
- 自動デプロイはしない。
レビューメモの例です。
## Technical SEO patch memo
Changed files:
Validation commands:
Before evidence:
After evidence:
Remaining risks:
Rollback:
Approval needed:
このメモは、あとで「なぜこの変更をしたのか」を確認するために重要です。SEO/GEOの技術修正は、数週間後に影響を見ることもあるため、変更理由と検証結果を残しておきます。
Codexに自動実行させてはいけないこと
| アクション | ブロックする理由 |
|---|---|
| 本番の | クロールアクセスを失う可能性がある |
| canonical ロジックを変更する | 間違ったURLへ統合してしまう可能性がある |
| noindex を追加または削除する | 重要ページをインデックスから外す可能性がある |
| URLを検索エンジンへ送信する | 外部検索エンジンの状態を変更する |
| redirect を変更する | トラフィックや計測を壊す可能性がある |
| テストなしでschemaを公開する | 無効な構造化データを作る可能性がある |
この表は、AGENTS.md にも入れておくと安全です。CodexがテクニカルSEOのタスクを受けたとき、どこから人間の承認が必要かを判断しやすくなります。
GEO向けのテクニカルチェック
GEOの可視性も、技術的にアクセスできるかどうかに左右されます。Codexには次を確認させます。
- 重要なanswer blockが、ユーザー操作なしでレンダリングされるか。
- FAQがレンダリング後HTMLで見えるか。
- 重要な定義がタブやアコーディオンの奥に隠れていないか。
- 公開ページが安定したstatus codeを返すか。
- 定義ページ、チュートリアル、計測ページが内部リンクでつながっているか。
- robotsルールが、有用なクローラーを誤ってブロックしていないか。
AI検索や回答エンジンは、ページ本文だけでなく、読み取りやすさ、引用しやすい構造、安定した公開状態も見ます。だからGEOでは、コンテンツ改善とテクニカルSEOを分けすぎないことが大切です。
FAQ
Codexにschemaを直接直させてもよいですか？
パッチ計画と検証の後だけです。Schemaはコードであり、検索向けmetadataです。本番コードと同じ扱いにします。
最初にやるべきテクニカルタスクは何ですか？
優先URL 10件の読み取り専用監査です。リポジトリ全体の自動書き換えから始めてはいけません。
修正が効いたかどうかはどう判断しますか？
before/after の証拠を必須にします。レンダリング後のページ出力、テストコマンド結果、ソースdiff、ロールバック手順をそろえます。
Codex SEO/GEO 学習パス
この記事は Codex SEO/GEO オペレーターシリーズの一部です。ゼロから構築する場合は、次の順番で進めてください。
- 2026年にCodexで自動GEOを実践する方法
- CodexでSEOを自動化する方法
- AGENTS.mdでCodex SEOワークスペースを作る方法
- MCPでCodexをSEOデータに接続する方法
- 2026年版：最も実用的なCodex GEO Skill
- キーワードクラスタリング用のCodex Skillを作る方法
- SERP、コンテンツ、テクニカルSEOでCodex Subagentsを使う方法
- 本番を壊さずにCodexでテクニカルSEOを修正する方法
- Codex Automationsで毎日のSEO/GEO監視を行う方法
- Codex SEO/GEO品質ゲート：Diff、証拠、テスト、人間の承認
- CodexでSEO/GEO対応のWebサイトを作成・デプロイする方法
次に読むべき記事
- 前の記事: SERP、コンテンツ、テクニカルSEOでCodex Subagentsを使う方法
- 次の記事: Codex Automationsで毎日のSEO/GEO監視を行う方法
- 関連記事: AGENTS.mdでCodex SEOワークスペースを作る方法
参考情報
現在の構文や製品挙動については、OpenAIの公式Codexドキュメントを信頼できる情報源として確認してください。
- Codex CLI: https://developers.openai.com/codex/cli
- AGENTS.md: https://developers.openai.com/codex/guides/agents-md
- Codex Skills: https://developers.openai.com/codex/skills
- Codex MCP: https://developers.openai.com/codex/mcp
- Codex subagents: https://developers.openai.com/codex/subagents
- Codex configuration: https://developers.openai.com/codex/config-reference
Author: Camille Rhodes, Auspiaで300以上のAIコンテンツワークフローを設計してきたアーキテクト。Camilleは、成長チーム向けにAI支援コンテンツシステム、自動化、編集品質管理について執筆しています。
