メインコンテンツへ移動
AIチュートリアル

Codex SEOチュートリアル：Codex CLIでウェブサイトのSEO、GEO、構造化データを監査する

本チュートリアルでは、Codex SEOのインストール方法と、Codex CLIを使ってサイト全体、単一ページ、テクニカル、コンテンツ、Schema、AI検索、ローカル、ECのSEO監査を実行する方法を解説します。レポート、API連携、差分監視、利用上の制約についても説明します。

約17分で読了
Codex SEOチュートリアル：Codex CLIでウェブサイトのSEO、GEO、構造化データを監査する

Codex SEO とは

Codex SEO は、OpenAI Codex CLI 上で動作する無料のオープンソース SEO 監査スキルです。Web サイトのアドレスを指定するだけでサイトを検査し、関連性のない警告を並べるのではなく、優先順位付きのアクションプランを生成します。

このプロジェクトは Agrici Daniel の claude-seo を移植したもので、上流の監査手法、スキル、スクリプトを Codex CLI 向けに適応しています。MIT ライセンスで提供され、サイト単位の料金はなく、サードパーティ製 SEO サービスのインストールも必要ありません。

Codex SEO 自体はオープンソースでサイト単位の課金もありませんが、監査の実行時には現在の Codex セッションで設定されているモデルを使用します。完全監査では複数の役割を実行するため、通常は単一ページの分析より多くのトークンを消費します。

主な機能

Codex SEO は 26 個のサブスキルと 19 個の専門家ロール用スクリプトで構成されています。完全監査では最大 17 個のロールが順番にサイトを分析し、各ロールの発見事項をファイルに記録します。

  • テクニカル SEO：クロール可能性、インデックス登録の手がかり、XML sitemap、robots.txt、リダイレクト、ページ速度、Core Web Vitals を検査します。
  • コンテンツと E-E-A-T：経験、専門性、権威性、信頼性、薄いコンテンツ、トピックの網羅状況を分析します。
  • 構造化データ：既存の Schema.org マークアップを検出・検証し、推奨マークアップを生成することもできます。
  • AI 検索と GEO：Google AI Overviews、AI Mode、ChatGPT、Perplexity、Gemini にページが引用される可能性を評価します。
  • エージェント対応：AI Agent のアクセス、llms.txt、Markdown、WebMCP などの関連機能を確認します。
  • ローカル・E コマース SEO：Google Business Profile、レビュー、マップパック、商品ページ、多言語サイトを対象にします。
  • 戦略と継続監視：業界別プラン、競合ページ、コンテンツブリーフ、セマンティッククラスタリング、SQLite スナップショットに基づく SEO ドリフト監視を提供します。

インストール前の準備

開始前に、次の環境を用意してください。

  • skills に対応した OpenAI Codex CLI。
  • Python 3.11 ～ 3.14。
  • リポジトリのクローンに使用する Git。

通常、SEO サービスの API key は必要ありません。インストーラーはスキルを ~/.agents/skills/ にコピーします。ここは Codex がユーザースキルを検出する場所です。また、ヘッドレスブラウザーを含む分離 Python 実行環境を作成し、システム全体の Python 環境は変更しません。

Codex SEO のインストール

macOS と Linux

リポジトリをクローンしてインストールスクリプトを実行します。

git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
bash codex-seo/install.sh

Windows PowerShell

PowerShell で実行します。

git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
powershell -ExecutionPolicy Bypass -File codex-seo\install.ps1

初期化と環境チェック

分離実行環境と Chromium を作成または更新する場合は、Codex CLI で次を実行します。

$seo setup

システムを変更せず環境だけを確認する場合は、次を実行します。

$seo doctor

$seo doctor は読み取り専用の診断コマンドです。インストール後や問題が発生したときに、依存関係の状態を確認するのに適しています。

初めて SEO 監査を実行する

  1. ターミナルで codex を実行し、Codex CLI を起動します。
  2. $seo を使ってスキルを呼び出します。
  3. 分析する Web サイトまたはページのアドレスを指定します。
  4. 各専門家ロールの分析が完了するまで待ち、生成されたアクションプランを確認します。
codex

$seo audit https://example.com

$seo audit はサイト全体の監査を実行するため、初めてサイト全体の問題を把握するときに適しています。システムは SaaS、ローカルサービス、E コマース、コンテンツサイト、代理店などのビジネスタイプを自動識別し、それに応じて検査項目を調整します。

自然言語で直接指示することもできます。

SEO 監査を実行してください。URL は https://example.com です

よく使う 4 つの入門コマンド

サイト全体の監査

$seo audit https://example.com

完全な専門家フローを実行し、優先順位付きの修正・最適化計画を出力します。各提案には、重要度、判断の根拠、依存項目、効果を検証する方法が記載されます。

単一ページの詳細分析

$seo page https://example.com/pricing

料金ページ、製品ページ、ランディングページ、記事ページだけを確認したい場合は、単一ページ分析を使用できます。コストの高い完全監査をすぐに実行せずに済みます。

AI 検索対応度の分析

$seo geo https://example.com

このコマンドは生成エンジン最適化を対象とし、ページが AI 検索で引用されやすいか、AI クローラーがアクセスできるか、Wikipedia、Reddit、YouTube、LinkedIn などの公開プラットフォームにおけるブランドの存在感を評価します。

構造化データのチェック

$seo schema https://example.com

ページ内の Schema.org マークアップを検出・検証し、構造化データの生成に関する提案を提示します。

目的に応じて監査コマンドを選ぶ

テクニカル SEO

  • $seo technical https://example.com：9 つのカテゴリにわたるテクニカル監査を実行します。
  • $seo sitemap https://example.com：サイトの XML sitemap を分析します。
  • $seo sitemap generate：XML sitemap を生成します。
  • $seo images https://example.com：画像の最適化に関する問題を分析します。
  • $seo hreflang https://example.com：多言語 hreflang 設定を監査または生成します。
  • $seo programmatic https://example.com：プログラマティック SEO を分析・計画します。
  • $seo unlighthouse https://example.com：ローカルで複数ページの Lighthouse 分析を実行します。

コンテンツと検索体験

  • $seo content https://example.com：E-E-A-T とコンテンツ品質を分析します。
  • $seo content-brief 目標トピック：目標キーワード、構成、内部リンクの提案を含むコンテンツブリーフを生成します。
  • $seo cluster 目標キーワード：SERP に基づくセマンティッククラスタリングを実行します。
  • $seo sxo https://example.com：ページタイプ、ユーザーストーリー、ペルソナなど、検索体験の要素を分析します。
  • $seo competitor-pages https://example.com：競合比較ページの提案を生成します。

ローカル、リンク、E コマース

  • $seo local https://example.com：GBP、サイテーション、レビュー、マップパックでのパフォーマンスを確認します。
  • $seo maps [command]：geo-grid、GBP 監査、競合半径などのマップインテリジェンス機能を使用します。
  • $seo backlinks https://example.com：Moz、Bing、Common Crawl などのソースから被リンクプロファイルを分析します。
  • $seo ecommerce https://example.com：E コマース SEO と市場インテリジェンスの分析を実行します。

完全監査の仕組み

  1. サイトタイプの識別：まずサイトが SaaS、ローカルサービス、E コマース、コンテンツサイト、代理店のどれに該当するかを判断し、その後の検査範囲を調整します。
  2. 専門家による順次分析：テクニカル、コンテンツ、構造化データ、速度、AI 検索などのロールが順番にタスクを実行します。
  3. 発見事項の保存：各ロールの完了後に独自の発見事項ファイルを保存し、結論の根拠を残します。
  4. 問題のスコアリング：発見事項をスコアリングし、単に出現順で表示することはありません。
  5. アクションプランの生成：最終レポートでは提案を優先順位順に整理し、理由、依存関係、検証方法を説明します。

レポートはデフォルトで Markdown として保存されます。PDF が必要な場合は、Codex に「PDF レポートを生成して」と指示し、$seo google report で出力できます。

応用的な使い方

小規模な分析から始めてサイト全体を監査する

完全な $seo audit はメインセッションで最大 17 個のロールを実行するため、単一ページのチェックより多くのトークンを消費します。大規模サイトでは、まず $seo page、$seo technical、$seo content、$seo schema で重要ページを確認してから、サイト全体の監査を実行するか判断できます。

業界別の戦略プランを生成する

$seo plan は SaaS、ローカルサービス、E コマース、コンテンツパブリッシャー、代理店などのタイプに対応しています。

$seo plan saas
$seo plan local
$seo plan ecommerce
$seo plan publisher
$seo plan agency

ビジネスに合ったタイプを使用すると、適切な検索シナリオに沿って計画を立てやすくなります。

Google データを接続する

Codex SEO は API key なしで使用できます。実際のフィールドデータが必要な場合は、次のコマンドで無料の Google API を設定できます。

$seo google setup

PageSpeed Insights、Chrome UX Report、Google Search Console、GA4 のデータを接続できます。キーはローカルにのみ保存されます。

Google API key を設定していない場合、Core Web Vitals は実験的な推定値となり、インデックス登録状況も主にページ情報から推測されます。重要な意思決定では、実際のフィールドデータと検索プラットフォームのデータを組み合わせて確認してください。

SEO のドリフトを監視する

Codex SEO は SQLite スナップショットを使用してベースラインを作成し、変化を比較して履歴を確認できます。

$seo drift baseline https://example.com
$seo drift compare https://example.com
$seo drift history https://example.com

これらのコマンドは、リニューアル、移行、テンプレート更新、継続的なコンテンツ公開の後に、SEO 状態にずれが生じていないか確認するのに適しています。

AI Agent がサイトを利用できるか確認する

$seo agentic https://example.com

このコマンドは、Lighthouse Agentic Browsing X/N、AIエージェントによるアクセス、llms.txt、Markdown、WebMCP などの項目をチェックします。$seo geo とは重点が異なり、前者はエージェントがウェブサイトを利用できるかに注目し、後者は生成型検索におけるページの発見可能性と引用可能性を重視します。

JavaScript サイトを監査する

Codex SEO は、Next.js、React、Vue、および JavaScript のレンダリングに依存するその他のウェブサイトに対応しています。ページの内容を表示するために JavaScript の実行が必要な場合は、ヘッドレスブラウザーを自動的に使用し、訪問者に表示されるページに基づいて監査します。

重要なコンテンツがスクロールやクリック後にのみ読み込まれる場合、結果にノイズが生じる可能性があります。このようなインタラクション領域は手動で確認し、自動監査の結論をブラウザーでの実際の表示と照合することをおすすめします。

オプション拡張

基本監査に有料拡張は必要ありませんが、プロジェクトには複数のオプション統合が用意されています。これらのサービスを使用する場合は、対応するアカウントまたは設定を自分で用意する必要があります。

  • $seo image-gen [use-case]：SEO 素材用の AI 画像を生成します。
  • $seo seranking [command]：ChatGPT、Gemini、Perplexity、AI Overviews、AI Mode における AI シェア・オブ・ボイスを分析します。
  • $seo profound [command]：LLM の引用とその時系列を追跡します。
  • $seo bing [command] https://example.com：Bing ウェブマスターツールと IndexNow の送信機能を使用します。

プライバシー、制約、アンインストール

データの処理方法

Codex SEO は Codex CLI 内で実行されます。分析対象のページと関連データは、現在の Codex セッションの背後で動作する OpenAI モデルに送信され、他の Codex タスクと同じ方法で処理されます。生成されたレポートはファイルとしてローカルに保存されます。

拡張機能や API を自分で接続しない限り、追加の SEO サービスにデータが送信されることはありません。一部のチェックでは、Wikipedia、Reddit、Common Crawl などの公開ソースを読み取る場合があります。

注意すべき制約

  • Google API に接続していない場合、Core Web Vitals は実験的な推定値になります。
  • 実際のプラットフォームデータに接続していない場合、インデックス登録状況は主にページから推定されます。
  • 重要なコンテンツの読み込みにスクロール、クリック、または複雑なインタラクションを必要とするページでは、ノイズが生じる可能性があります。
  • 完全監査ではより多くのトークンを使用するため、ウェブサイトの規模に応じてコマンドを選択してください。

アンインストール

使用しなくなった場合は、リポジトリに用意されているアンインストールスクリプトを実行できます。

bash uninstall.sh

このコマンドは、インストール済みのスキルを削除します。

まとめ

Codex SEO は、技術チェック、コンテンツ品質、Schema、GEO、ローカル SEO、EC SEO、継続的なモニタリングを Codex CLI に統合します。まず $seo doctor で環境を確認し、次に $seo page または専門コマンドで手順に慣れ、最後に $seo audit で優先順位付きの包括的なアクションプランを生成することをおすすめします。

すべてのパラメーターと拡張設定を確認するには、プロジェクトの GitHub リポジトリおよび、そこにあるインストール、コマンド、アーキテクチャ、トラブルシューティング、セキュリティ、プライバシーに関するドキュメントをご覧ください。