SEO業務の自動化 (seo-ops)
seo MCPサーバーのブートストラップ、pre-pushおよびCI/CD品質ゲートの統合、エビデンスに基づく技術監査およびランキング監査を自動化するランブックです。
フェーズ0：必須の事前確認と自動インストール
[!IMPORTANT] ゼロ手動セットアップ前提：コード分析や監査を始める前に、
seoCLIとMCPサーバーが現在のセッションで構成済みで利用可能であることを確認します。
flowchart TD
Start["/seo-ops を呼び出し"] --> Check{"SEO MCP / CLI は構成済みか？"}
Check -->|いいえ / 未構成| AutoInstall["1. 自動インストールを実行<br/>('npm i -g seo' + mcp_config.json を書き込み)"]
AutoInstall --> TestDaemon["2. 確認: 'npx -y seo mcp serve --test'"]
TestDaemon --> PromptRestart["3. ユーザーにエージェント/IDEの再起動を促し、処理を停止"]
Check -->|はい / アクティブ| RouteIntent["ユーザーの意図に応じてルーティング"]
セルフインストールランブック（MCP / CLIがない場合に実行）
- パッケージをインストール:
npm install -g seo - MCPサーバーを構成:
.agents/mcp_config.json（および~/.gemini/config/mcp_config.json）に以下が含まれていることを確認します:{ "mcpServers": { "seo": { "command": "npx", "args": ["-y", "seo", "mcp", "serve"] } } } - デーモンを確認:
npx -y seo mcp serve --test - 再起動を促し、ターンを停止:
このセッションでMCPツールが新しく追加された場合、Antigravityではツールを登録するためにセッション/ウィンドウのリロードが必要です。明確に伝えます:
"
seoCLIとMCPサーバーがインストールされ登録されました。IDEウィンドウをリロードするか、エージェントセッションを再起動して新しいMCPツール（seo_list_reports、seo_describe_report、seo_run_report）を読み込んでから、再度/seo-opsを呼び出してください。" アクティブなツールなしで手動でコード編集や推測による回答を行わないでください。
アクティブな意図ルーティング（MCP / CLIが準備できている場合）
前提条件が満たされたら、ユーザーに促すかコンテキストを調べて目標を特定します:
flowchart LR
Route["アクティブセッション"] --> A["1. CI/CD & Pre-Push セットアップ (setup-cicd)"]
Route --> B["2. 技術的 & オンページ監査 (audit-technical)"]
Route --> C["3. Search Console & 成長監査 (audit-gsc)"]
Route --> D["4. 環境ヘルスチェック (check-health)"]
パスウェイA: リポジトリCI/CD & Pre-Push品質ゲート (setup-cicd)
開発およびデプロイパイプラインで、回帰ゼロのSEOゲートを強制します:
- 1. Node 22+ を確認:
node -vを実行し、Node 22+ ランタイムが使用されていることを確認します。 - 2. ローカルPre-Pushフックを構成:
- Pre-pushランナースクリプト（
scripts/seo-pre-push.ps1またはscripts/seo-pre-push.sh）を展開し、開発サーバーの自動プローブ（アクティブなインスタンスを再利用するか、プロセツリークリーンアップ付きでcmd.exe /c pnpm run devを起動）を行います。 .husky/pre-pushで、離散ステップを実行:pnpm run test:all pnpm run seo:pre-push- cicd-pipeline-guide.md を参照してください。
- Pre-pushランナースクリプト（
- 3. GitHub Actionsワークフローをインストール:
.github/workflows/seo-check.ymlを seo-ci.yml.template を使用して作成します。
- 4. パイプラインを検証:
- Windows:
powershell -ExecutionPolicy Bypass -File .agents/skills/seo-ops/scripts/verify-seo-setup.ps1 -Mode cicd - Linux/macOS:
bash .agents/skills/seo-ops/scripts/verify-seo-setup.sh -m cicd
- Windows:
パスウェイB: 技術的 & オンページ監査 (audit-technical)
ローカルビルドまたはライブURLに対して、エビデンスに基づくクロールを実行します:
- 1. ローカルビルド/ターゲットを起動:
http://127.0.0.1:3000でpnpm build && pnpm startを実行します。
- 2. 技術監査を実行:
- MCP経由:
seo_run_reportをreportId: "audit-page"または"site-crawl"、params: {"url": "http://127.0.0.1:3000"}で呼び出します。 - CLI経由:
npx -y seo report --url http://127.0.0.1:3000 --actions-only --json
- MCP経由:
- 3. Next.jsコードを修正:
generateMetadata()を更新（title、description、OpenGraph、canonicals）。- JSON-LD構造化データコンポーネント（
BreadcrumbList、Article、WebSite）を修正。 - 内部の壊れた
<Link>タグとapp/sitemap.tsを修正。 - ranking-optimization-guide.md を参照してください。
- 4. 修正を確認:
seo audit-page --url <target-url>を再実行し、クリーンなゼロ検出状態を確認します。
パスウェイC: Search Console & 成長機会 (audit-gsc)
Search Consoleを使用して、ライブドメインでのランキング機会を発見します:
- 1. MCP経由でレポートを発見:
seo_list_reportsを呼び出し（カテゴリ:"gsc"または"pseo"）。reportId: "quick-wins"、"second-page"、または"pseo-patterns"に対してseo_describe_reportを呼び出します。
- 2. 機会監査を実行:
- ターゲットプロパティ（
site: "sc-domain:example.com"）を指定してseo_run_reportを呼び出します。
- ターゲットプロパティ（
- 3. 改善を適用:
- Quick Wins（4–10位）:
<title>と<meta description>を改善し、CTRを向上させます。 - Second Page（10–20位）: 高権威の親ページからコンテキスト内部リンクを追加し、コンテンツを充実させます。
- pSEOパターン:
generateStaticParams()で動的ルートをスキャフォールディングします。
- Quick Wins（4–10位）:
- 4. 再確認: 更新されたメタとスキーマが本番SSRビルドでレンダリングされることを確認します。
エッジケースと既知の落とし穴
- プロセス再起動の要件:
.agents/mcp_config.jsonが変更された場合、エージェントはセッション/ウィンドウがリロードされるまで新しいツールにアクセスできません。再起動のプロンプトを絶対にスキップしないでください。 - Windowsパス解決: 常に
"command": "npx"と["-y", "seo", "mcp", "serve"]を使用して、Windows の%PATH%バイナリ検索エラーを回避してください。 - 静的推測禁止: MCPツールまたはCLIレポートを最初に実行せずに、SEOのためにコードを静的に検査しないでください。
- エビデンスの分離: 観測されたクロールエビデンスは、外部プロバイダーのキーワード推定とは別に保持してください。