seo-flow について
seo-flowは、5段階にわたる41個の構造化プロンプトを使ってFLOWフレームワークを適用するCodex SEOスキルです。SEO調査、権威性向上、最適化、コンバージョン、ローカル検索を扱い、依頼内容や状況に応じてプロンプトを選びます。
主な機能
- 015段階のFLOWフレームワーク
- 0241個の構造化プロンプト
- 03状況に応じたプロンプト選択
- 04ローカルSEOとコンバージョンのワークフロー
- 05プロンプトライブラリの同期
活用シーン
- 01キーワードとSERP意図の調査
- 02被リンクとオフサイト権威性向上の計画
- 03対象を絞ったページ最適化タスクの選定
- 04ローカルSEOやコンバージョン機会の検討
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ agricidaniel/ codex-seo --skill seo-flowインストール後、Claude Code で/seo-flowを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/bibliography.mdflow-framework.mdflow-prompts.lockreferences/prompts/find/content-planning-for-topical-relevance-prompt.mdcontent-prioritization-prompt.mdkeyword-research-prompt.mdkeyword-variations-for-topical-relevance-prompt.mdprompt-audience-avatar.mdreferences/prompts/leverage/backlink-competition-prompt.mdreferences/prompts/local/ai-homepage-rewrite-prompt.mdclaude-deep-research-prompt.mdgbp-categories-prompt.mdgbp-description-claude-prompt-1.mdgbp-description-claude-prompt-2.mdgbp-description-claude-prompt-3.mdgbp-services-prompt.mdprompt-generating-a-meta-description.mdprompt-generating-a-title-tag.mdprompt-rewriting-existing-homepage.mdprompt-rewriting-existing-service-page.mdreferences/prompts/optimize/ai-detector-test-follow-up-prompt.mdai-supporting-pages-rewrite-prompt.mdbasic-prompt.mdblog-post-outline-prompt.mdblog-post-writing-prompt.mdclaude-prompt-1.mdclaude-prompt-2.mdctr-audit-prompt.mdfollow-up-prompt-1.mdfollow-up-prompt-2.md詳細
FLOW フレームワーク — Find · Leverage · Optimize · Win
共有データキャッシュ
ステップ 0 -- 共有データキャッシュを確認します:
情報を収集する前に、.seo-cache/ を確認し、関連する SEO スキルから再利用できるコンテキストがないか調べます。
スキーマと依存関係マップについては、../seo/references/shared-data-cache.md を参照してください。
次のキャッシュファイルが存在する場合は確認します:
-
.seo-cache/site-meta.json:ドメイン、ビジネスタイプ、業界、クロールのコンテキスト -
.seo-cache/audit-scores.json:以前の全体監査での優先事項 -
.seo-cache/pages/{url-slug}/page-analysis.json:URL が指定されている場合のページ単位のコンテキスト -
見つかった場合:明らかに有効なフィールドを解析して使用します(「[日付] の [X] をキャッシュから使用」と記録します)
-
見つからない場合、破損している場合、または無関係な場合:新しいエビデンスを使って続行します
-
ユーザーが「refresh」または「re-run」と言った場合:キャッシュの読み取りを無視し、書き込み時に上書きします
フレームワークとプロンプト © Daniel Agrici、CC BY 4.0 — github.com/AgriciDaniel/flow
FLOW は、AI 検索時代に向けて構築された、エビデンス主導の SEO 運用モデルです。Codex SEO は FLOW プロンプトライブラリ(5 つのステージにわたる 41 個のプロンプト)を統合しており、すべての分析を 即興のクエリではなく、構造化されたエビデンスに裏付けられた AI プロンプトで実行できます。
実行時のコンテキスト: /seo flow を実行するたびに references/flow-framework.md を読み込みます。
プロンプトファイルは、ユーザーがリクエストしたステージの分だけオンデマンドで読み込みます。
コマンド
| コマンド | 機能 |
|---|---|
/seo flow | FLOW の概要とステージメニューを表示します |
/seo flow find [url|topic] | Find ステージ:キーワード調査、ギャップ分析、SERP の検索意図マッピング(5 個のプロンプト) |
/seo flow leverage [url] | Leverage ステージ:バックリンク戦略、オフサイトのオーソリティ(1 個のプロンプト) |
/seo flow optimize [url] | Optimize ステージ:コンテキストに基づき、最も関連性の高いプロンプトを 21 個から 2~3 個選択します |
/seo flow win [url] | Win ステージ:BOFU、コンバージョン率、デュアルサーフェスのスコアカード(3 個のプロンプト) |
/seo flow local [url] | Local ステージ:GBP の最適化、メタデータ、タイトルタグ、ローカル監査(11 個のプロンプト) |
/seo flow prompts | 41 個すべてのプロンプトの完全なインデックスを表示します(ステージ、名前、トリガー条件) |
/seo flow sync | github.com/AgriciDaniel/flow から最新のプロンプトファイルを取得します |
オーケストレーションロジック
/seo flow の場合(サブコマンドなし)
references/flow-framework.mdを読み込みます- 各ステージの説明を 1 行ずつ添えて、FLOW のステージ概要を表示します
- ユーザーの現在の状況に合うステージを尋ねます
/seo flow find [url|topic] の場合
references/prompts/find/内のすべてのファイルを読み込みます- 各プロンプトを URL またはトピックに適用します
- 相互参照:「SERP の詳細なクラスタリングについては、
/seo cluster <seed-keyword>を参照してください」
/seo flow leverage [url] の場合
references/prompts/leverage/内のファイルを読み込みます- URL の現在のバックリンクのコンテキストに適用します
- 相互参照:「未加工のバックリンクデータについては、
/seo backlinks <url>を参照してください」
/seo flow optimize [url] の場合
references/prompts/optimize/内のすべてのファイル名を読み込みます- 以前の分析コンテキスト(URL、業界分野、会話内の以前のスキル出力)を読み込みます
- 最も関連性の高いプロンプトを 2~3 個選び、それらのファイルだけを読み込みます
- 選択したプロンプトを適用し、ほかのプロンプトには
/seo flow promptsからアクセスできることを伝えます - 相互参照:「コンテンツ品質の全体分析については、
/seo content <url>と/seo geo <url>を参照してください」
/seo flow win [url] の場合
references/prompts/win/内のすべてのファイルを読み込みます- 各プロンプトを URL のコンバージョンおよび BOFU のコンテキストに適用します
- 相互参照:「SXO のペルソナスコアリングについては、
/seo sxo <url>を参照してください」
/seo flow local [url] の場合
references/prompts/local/内のすべてのファイルを読み込みます- URL のローカル SEO コンテキストに適用します
- 相互参照:「ローカル SEO の全体分析については、
/seo local <url>と/seo maps [command]を参照してください」
/seo flow prompts の場合
references/prompts/README.mdを読み込みます- 41 個すべてのプロンプトについて、ステージ、名前、トリガー条件を含む完全なインデックスを表示します
/seo flow sync の場合
- 次を実行します:
python scripts/sync_flow.py - JSON の概要(追加、更新、変更なしのファイル)を表示します
- 同期が完了した後、帰属表示を提示します
コンテキストのマッチング(最適化ステージ)
最適化ステージには21個のプロンプトがあります。21個すべてを読み込むとノイズになります。優先順位に基づいて選択してください。
- 業界分野(SaaS → オンページ + テクニカル、ローカル → サイテーション + GBP、パブリッシャー → E-E-A-T + 最新性)
- 以前のスキル出力(seo-technical でクロールの問題が指摘された場合 → テクニカル最適化プロンプト、seo-content で E-E-A-T の不足が指摘された場合 → コンテンツ最適化プロンプト)
- URL シグナル(製品ページ → コンバージョン、ブログ → 最新性 + オーソリティ)
必ずプロンプトを2~3個だけ提示してください。選んだプロンプトと、その理由を明記してください。
参照ファイル
必要に応じて読み込んでください。起動時にすべて読み込まないでください。
references/flow-framework.md— FLOW の運用モデル(/seo flowを起動するたびに読み込みます)references/bibliography.md— 根拠となる情報源。研究や統計を引用する場合に読み込みますreferences/prompts/README.md— プロンプトの一覧。/seo flow promptsで読み込みますreferences/prompts/find/— プロンプト5個。/seo flow findで読み込みますreferences/prompts/leverage/— プロンプト1個。/seo flow leverageで読み込みますreferences/prompts/optimize/— プロンプト21個。/seo flow optimizeで必要なものだけを読み込みますreferences/prompts/win/— プロンプト3個。/seo flow winで読み込みますreferences/prompts/local/— プロンプト11個。/seo flow localで読み込みます
帰属表示
すべての /seo flow の起動(サブコマンドを問わず)では、分析の前に次を出力します。
Framework and prompts © Daniel Agrici, CC BY 4.0 — github.com/AgriciDaniel/flow
帰属表示を省略したり、変更したりしないでください。
エラー処理
| 状況 | 対応 |
|---|---|
references/flow-framework.md が見つからない | 「FLOW の参照ファイルが同期されていません。/seo flow sync を実行してください」 |
| プロンプトファイルが見つからない | 「FLOW リポジトリから最新のプロンプトを取得するには、/seo flow sync を実行してください。」 |
sync_flow.py のネットワークエラー | スクリプトの stderr を表示します。レート制限を確認します:gh api rate_limit。 |
sync_flow.py の認証エラー | gh auth login を実行してから再試行します。 |
共有データキャッシュへの書き込み
すべての作業が完了した後、ワークフローによって永続的な知見が得られた場合は、.seo-cache/ に簡潔な JSON サマリーを書き込みます。
../seo/references/shared-data-cache.md のスキーマと命名規則を使用してください。cache_type、analyzed_at、ソース URL/ドメイン、主な知見、問題点、推奨事項、ツールの制限事項を最低限含めてください。.gitignore に .seo-cache/ がない場合は追加してください。