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）。URL あたり約 $0.005。月 20 URL 以上のスイープに対して PageSpeed Insights に代わるもの。
- /v3/on_page/instant_pages — ページレベルのオンページ分析（タイトル長、メタディスクリプション、スキーマタイプ、内部・外部リンク数、非推奨タグ、コンテンツ整合スコア）。$0.001/URL。コンテンツヘルスチェックの最安単一エンドポイント。
- /v3/ai_optimization/{engine}/llm_responses/live — ChatGPT / Perplexity / Gemini をウェブ検索有効で直接クエリし、レスポンステキストと引用リストを取得。約 $0.03/回。実際の AI 検索可視性トラッキングを駆動するエンドポイント。
- /v3/dataforseo_labs/google/keyword_overview — 検索ボリューム、難易度、インテント分類、月別トレンド。キーワードデータのバックボーン。キーワードあたり $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 はスモークテストで実際のレスポンス形状を読み、ミスマッチをデバッグし、パーサーを修正する。「検証後完了」というスキルは、実際のレスポンスが正しく解析されるまで完了を宣言することを拒否する。
2. Cron とキャッシュ規律
DataForSEO のコストは積み重なる。ここの LLM メンショントラッカーは月 $0.03 × 30 プロンプト × 月 4 回実行 = 月 $10～12。これが機能するのは週次だから。時間単位で実行すれば、コストは 168 倍。生き残るパターン：Supabase への cron 駆動書き込み、キャッシュからの公開読み取り、JWT ゲート後ろの手動フォースリフレッシュ。Claude Code フックレイヤーはこれを強制する — コミット前チェックは率制限またはキャッシュヘッダーなしで有料エンドポイントを呼び出すコードのプッシュを拒否する。
3. デプロイゲート
スケジュール関数は本番環境メインでのみ実行されます。月曜日ごとに seo_llm_runs に書き込むトラッカーは、月曜日の前にマージされる必要があります。Claude Code のセッションハンドオフ規律がこれをキャッチします。昨日の HANDOFF ドキュメントには文字通り「この月曜日 09:00 UTC クローンは、本番環境 Netlify にこれがランディングされてからのみ実行される」と書かれており、マージゲートはドキュメント化され、作業がクローズされる前に実装されます。
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、各 H3 は3〜5候補。出力: 人間によるレビュー準備完了の Markdown アウトライン。このステップは人間がゲートを設定します — 完全自動化なし。'requesting-code-review' スキルはコンテンツにも適用されます。
ステップ5. ドラフト生成、RDA Humaniser、取り込み
Claude(大量生産は Sonnet 4.6、フラッグシップは Opus 4.7)が承認されたアウトラインに対してドラフトを作成します。出力は RDA Humaniser パスを通過します — AI特性を削除し、均一な文のリズムを破り、句の長さを変動させます。その後 Supabase に status='ready' として取り込みます。2回目の人間レビューが status を '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週間に短縮できます。これが提供する契約内容です。
契約内容
3つのプロジェクト形式から選べます。フィーチャービルド：特定の自動化サーフェス1つ（引用トラッカー、コンテンツブリーフジェネレーター、Lighthouse スイープ）、1～2週間、£5k-£15k。プロダクトサーフェスビルド：マーケティングサイト + 管理ダッシュボード + コンテンツパイプライン + 自動化フック、4～8週間、£15k-£45k。プラットフォームビルド：マルチドメイン、マルチロケール、カスタム統合を備えた完全な SEO 自動化スタック、12～20週間、£45k-£150k。
ディスカバリーは有料1週間です。納品物は書面の技術仕様書、固定価格見積もり、DataForSEO と Anthropic の組み合わせが本番ビルド前にあなたの特定のコードベースで動作することを証明する動作確認済みのスモークテストです。30分間のコール予約で始めてください。