SEO自動化スタック2026：Cronに耐える設計

DataForSEOブログには、彼らのエンドポイントをNLP APIと組み合わせてSEOコンテンツワークフローを自動化する方法についての有用な記事があります。説明されているAPIサーフェスは実在します。月曜日09:00 UTCのcron、キャッシング、レート制限、デプロイゲート、エラーリプレイ、コスト上限に対応したバージョンは、デモと比べて大きく異なって見えます。

このサイトは本番版を実行しています。/admin/llm-mentions/ ダッシュボードは週次 cron で本物の DataForSEO ai_optimization ペイロードを取得しています。/tools/ai-citation-checker/ は IP レート制限付きでパブリックトラフィックに無料の DataForSEO SERP + AI Overview チェックを公開しています。毎週月曜日に実行される 47 URL の Lighthouse スイープは $0.30 であり、$40/月の PageSpeed Insights サブスクリプションの代替です。パイプライン全体は Claude Code で 4 営業日にわたって構築されました。

そのスタックが実際にどのように見えるのか、そして何を自動化するか人間が行うかを決定する場所です。

チェーンする価値のある 5 つの DataForSEO エンドポイント

本番環境で機能するSEO自動化のほとんどは、これら5つの組み合わせを使用しています。すべてを同時に使うわけではなく、ユースケースによって選びます。

/v3/serp/google/organic/live/advanced、キーワードの現在の上位10オーガニック検索結果とAI Overview検出。引用トラッカーの基盤。
/v3/on_page/lighthouse/live/json、完全なLighthouse監査（性能/アクセシビリティ/ベストプラクティス/SEO + Core Web Vitals）。1URLあたり約$0.005。月20URL以上のスイープの場合、PageSpeed Insightsに代わります。Core Web Vitals). Costs ~$0.005 per URL. Replaces PageSpeed Insights for any sweep above ~20 URLs/month.
/v3/on_page/instant_pages、ページレベルのオンページ分析（タイトル長、メタディスクリプション、スキーマタイプ、内部/外部リンク数、非推奨タグ、コンテンツ一貫性スコア）。1URLあたり$0.001。コンテンツヘルスの最もコストが低い単一エンドポイント。
/v3/ai_optimization/{engine}/llm_responses/live、ChatGPT/Perplexity/Geminiに直接クエリを実行し、ウェブ検索を有効にして、レスポンステキストと引用リストを取得。約$0.03/実行。実際のAI検索可視性トラッキングを支えるエンドポイント。
/v3/dataforseo_labs/google/keyword_overview、検索ボリューム、KD、インテント分類、月次トレンド。キーワードデータの基盤。1キーワードあたり$0.001とコストが低い。

Claude Codeの部分、モデルが実際に行うこと

このスタック内での Claude Code の価値は API コール自体にはない。コールは認証ヘッダー付きのフェッチであり、新人エンジニアなら誰でも書ける。価値は 4 つの場所に存在する。

1. スキーマ解析

DataForSEOのレスポンスは深くネストされています。/v3/on_page/lighthouse/live/jsonはカテゴリをtasks[0].result[0].categoriesで返し、推測するとitems[0].categoriesではありません。/v3/ai_optimization/.../llm_responses/liveは、テキストをresult.items[].sections[].textの内部に返し、典型的なAI APIより2レベル深いです。Geminiはすべての引用URLをvertexaisearch.cloud.google.com/grounding-api-redirect/<token>でラップしているため、実際のソースドメインはURLフィールドではなく引用タイトルにあります。Claude Codeはスモークテストで実際のレスポンス形状を読み込み、ミスマッチをデバッグし、パーサーを修正します。「verification-before-completion」スキルは、実際のレスポンスが正しく解析されるまで完了を宣言することを拒否します。

2. Cron とキャッシュ規律

DataForSEOのコストは積み重なる。ここで言及されているトラッカーは$0.03/実行 × 30プロンプト × 月4回実行 = 月$10-12。週次だから成立する。時間単位で実行すれば費用は168倍になる。生き残るパターン：Supabaseへのcron駆動書き込み、キャッシュからの公開読み取り、JWTゲート背後の手動強制リフレッシュ。Claude Codeフック層がこれを強制し、pre-commitは有料エンドポイントをレート制限＋キャッシュヘッダーなしで呼び出すコードをプッシュ拒否する。Supabase, public reads from cache, manual force-refresh behind a JWT gate. The Claude Code hook layer enforces this, pre-commit refuses to push code that calls a paid endpoint without rate-limit + cache headers.

3. デプロイゲート

スケジュール関数は本番mainのみで発火する。毎週月曜日にseo_llm_runsに書き込むトラッカーは月曜日前にマージしなければならない。Claude Codeのセッションハンドオフ規律がこれをキャッチする。昨日のハンドオフドキュメントには文字通り「月曜日09:00 UTCのcronはこれが本番Netlifyにランディングしてから1度だけ発火する」と書かれており、マージゲートはドキュメント化され、作業クローズ前に強制される。Netlify', the merge gate is documented and enforced before the work is closed.

4. エラーリプレイ

DataForSEOはタスク失敗時にHTTP 200とstatus_code: 40402をJSONボディ内で返す。単純なfetch().then(r => r.json())は成功と判断する。本番コードは内部のstatus_codeを読み取り、4xxで再試行し、デバッグテーブルに生のタスクラッパーをログしてフォレンジックに備える。Claude Codeの体系的デバッグスキルはこれがトリップした時に仮説駆動デバッグを強制し、仮説を記述し、最小テストを設計し、さらに絞り込む。スモークスクリプト(このサイトのscripts/smoke-llm-mentions.mjs)は完全なcronが$5のAPI支出を消費する前にGemini URLラッピングバグをサーフェスしたアーティファクトだった。

5段階のコンテンツワークフロー、本番環境形式

DataForSEO の記事は、コンテンツ生成チェーンについて説明しています: SERP → AI サマリー → サブトピック → テキスト生成。ここに、本番環境規律を適用したときに同じチェーンがどのように見えるかを示します。

ステップ 1. キャッシュ付き SERP フェッチ

ターゲットキーワードに対して POST /v3/serp/google/organic/live/advanced を実行します。上位 10 件の結果を 7 日間の TTL でSupabase にキャッシュします。同じキーワードでのその後のブリーフはすべてキャッシュから読み込みます。ロングテール上の API 費用の 95% を節約できます (ほとんどのクエリは同じキーワード周辺で集まります)。

ステップ 2. プロンプトキャッシュを使用した AI サマリー

上位 10 件の結果 URL を Anthropic Claude (Sonnet 4.6、システムメッセージでプロンプトキャッシュ) にパイプします。サマリーは「これらの結果全体に共通のテーマは何か? 普遍的に引用されているエンティティは何か?」と尋ねます。出力: 400 語の共通パターンブリーフ。Anthropic プロンプトキャッシュは、リピートキーワードのコストを 75% 削減します。

ステップ3. エンティティカバレッジマップ

POST /v3/content_analysis/searchにターゲットキーワードを指定。トップランキングコンテンツ全体でのブランド/プロダクトメンション、感情スコアを返す。出力：ドラフトが完全に見えるために言及すべきエンティティのリスト。キーワードが一般的な場合はこのステップをスキップ、買い手タイプのクエリ(商業意図)でのみ価値がある。

ステップ4. サブトピック構造

Anthropicを使ってSERP概要＋エンティティマップを提案H2/H3構造に変換。6～9個のH2、各3～5個の候補H3。出力：人間レビュー準備完了のMarkdownアウトライン。このステップは人間がゲート、完全自動化なし。「コードレビューリクエスト」スキルはコンテンツにも適用される。

ステップ5. ドラフト生成、RDA Humaniser、取り込み

Claude(バルク向けSonnet 4.6、フラッグシップ向けOpus 4.7)は承認アウトラインに対してドラフトを執筆。出力はRDA Humaniserパスを通過し、AI痕跡を削除、均一な文リズムを分割、句長を変化させる。その後Supabaseに状態='ready'として取り込む。2番目の人間レビューが承認してから状態が'published'に反転する。

このサイトの本番パイプラインからの実数

/tools/ai-citation-checker/ は同じチェーンの簡略版を使用しています。2026年5月の実績値:

DataForSEO SERP コール: 5クエリ × $0.001 = $0.005(引用チェック1回あたり)
Anthropic Claude サマリー: 約$0.02(チェック1回あたり、Sonnet 4.6、プロンプトキャッシュ使用)
パブリックツール使用あたりの実効コスト：約$0.03
レート制限：IP あたり 1 時間に 3 回の新規チェック、キャッシュ結果は無制限
日次最悪ケース：全 IP で完全飽和時に約$15
キャッシング後の実際の日次支出：約$0.80（キャッシュクエリが人気ブランド検索トラフィックの 90%+ を占める）

何を自動化するか、何を手動で対応するか

自動化する対象

SERP 取得、キャッシング、監視
大規模 Lighthouse + ページヘルス監査
ChatGPT、Perplexity、Gemini にわたる LLM 引用追跡
Schema + メタ + hreflang 検証
コンテンツブリーフのスキャフォルディング（アウトライン＋エンティティカバレッジマップ）
大量のロングテール向け初期ドラフト生成（ステータスコードページ、ロケーションページなど）

人間を関わらせておく

ドラフト生成前のアウトライン承認、このゲートなしの自動化は大規模で汎用コンテンツを生成
公開前の最終レビュー、すべてのフラッグシップ投稿
トピカルオーソリティ戦略、どのクラスタを構築するか、何をスキップするか
ディスカバリーとスコーピングコール、30分間のコールで読み取った買い手シグナルは自動ワークフローに転送されない
ペナルティ診断とリカバリー、Google Search Consoleの異常には過去のサイトに対するパターンマッチングが人的判断として必要

DataForSEO記事が終わるところと、本番環境が始まるところ

DataForSEO記事はAPIサーフェスとハッピーパスデモを示します。本番レイヤーは、そのデモと実際にランクされるサイトの間にあるすべてです：キャッシュ戦略、cronスケジュール、force-refresh時のJWTゲート、直接本番書き込みをブロックするフック、レスポンス形状を検証する smoke テスト（API支出をする前に）、Supabase書き込み再試行、デプロイゲート、エラーリプレイ。デモにはそれらは何も含まれていません。なぜなら、それらはAPIの問題ではなく、インフラストラクチャの問題だからです。

DataForSEO のAPI仕様が必要であればDataForSEO のドキュメントはよく書かれています。本番レイヤーをコードベースに連携させたいのであれば、単一ドメイン設定で大体4～6週間の作業を見積もっています。マルチドメインやマルチロケール対応が必要であればさらに長くなります。Claude Code を使えばこれを2～3週間に短縮できます。これが提供する契約内容です。

月曜日のcronに耐えるSEO自動化スタック