DataForSEO: ライブ SEO データ（拡張機能）

DataForSEO MCP サーバーを経由したライブ検索データ。リアルタイム SERP 結果 （オーガニック + 画像）、キーワード指標、バックリンク プロファイル、オンページ分析、 コンテンツ分析、ビジネスリスティング、AI 可視性チェック、LLM 言及追跡を 10 個の API モジュールと 79 以上の MCP ツールで提供します。

前提条件

このスキルは DataForSEO 拡張機能のインストールが必要です：

./extensions/dataforseo/install.sh

利用可能性の確認： DataForSEO ツールを使用する前に、serp_organic_live_advanced または他の DataForSEO ツールが利用可能か確認して MCP サーバーが接続されていることを確認してください。ツールが利用可能でない場合は、拡張機能がインストールされていないことをユーザーに通知し、インストール手順を提供してください。

API クレジット認識

DataForSEO は API 呼び出しごとに料金を請求します。効率的に使用してください：

• 複数の単一呼び出しよりも一括エンドポイントを優先
• ユーザーが特に指定しない限り、デフォルト パラメータ（US、英語）を使用
• セッション内で精神的に結果をキャッシュし、同じデータを再フェッチしない
• 費用のかかる操作（完全なバックリンク クロール、大規模なキーワード リスト）を実行する前にユーザーに警告

コスト ガードレール

すべての DataForSEO MCP 呼び出しの前に コスト推定を実行してください：

python scripts/dataforseo_costs.py check <endpoint> [--count N]

• "status": "approved" の場合 → API 呼び出しを実行
• "status": "needs_approval" の場合 → コスト推定をユーザーに表示し、進行前に確認を取得
• "status": "blocked" の場合 → ユーザーに日次予算上限が超過することを通知し、進行しない

各 API 呼び出し完了後 コストをログに記録：

python scripts/dataforseo_costs.py log <endpoint> <actual_cost>

コスト管理のユーザー コマンド：

• /seo dataforseo costs today → 本日の支出内訳を表示
• /seo dataforseo costs summary → 7 日間の支出履歴を表示
• /seo dataforseo costs config --mode threshold --threshold 0.50 → 承認モードを設定

references/cost-tiers.md を読み込んで、完全な価格表、予算プリセット、コスト削減のヒントを確認してください。

クイック リファレンス

コマンド	説明
/seo dataforseo serp <keyword>	Google オーガニック SERP 結果
/seo dataforseo serp-images <keyword>	Google Images SERP 結果
/seo dataforseo serp-youtube <keyword>	YouTube 検索結果
/seo dataforseo youtube <video_id>	YouTube ビデオ詳細分析
/seo dataforseo keywords <seed>	キーワード提案とアイデア
/seo dataforseo volume <keywords>	キーワードの検索ボリューム
/seo dataforseo difficulty <keywords>	キーワード難易度スコア
/seo dataforseo intent <keywords>	検索意図の分類
/seo dataforseo trends <keyword>	Google トレンド データ
/seo dataforseo backlinks <domain>	完全なバックリンク プロファイル
/seo dataforseo competitors <domain>	競合ドメイン分析
/seo dataforseo ranked <domain>	ドメインのランク付けキーワード
/seo dataforseo intersection <domains>	キーワード/バックリンク重複
/seo dataforseo traffic <domains>	一括トラフィック推定
/seo dataforseo subdomains <domain>	ランキング データ付きサブドメイン
/seo dataforseo top-searches <domain>	ドメイン言及の最頻検索クエリ
/seo dataforseo onpage <url>	オンページ分析（Lighthouse + 解析）
/seo dataforseo tech <domain>	テクノロジー スタック検出
/seo dataforseo whois <domain>	WHOIS 登録データ
/seo dataforseo content <keyword/url>	コンテンツ分析とトレンド
/seo dataforseo listings <keyword>	ビジネスリスティング検索
/seo dataforseo ai-scrape <query>	ChatGPT ウェブ スクレーパー（GEO 用）
/seo dataforseo ai-mentions <keyword>	LLM 言及追跡（GEO 用）

---

SERP 分析

/seo dataforseo serp <keyword>

ライブ Google オーガニック検索結果を取得。

MCP ツール： serp_organic_live_advanced

デフォルト パラメータ： location_code=2840（US）、language_code=en、device=desktop、depth=100

対応内容： serp_organic_live_advanced ツールは se パラメータを通じて Google、Bing、Yahoo をサポートします。検索エンジンを切り替えるために「bing」または「yahoo」を指定してください。

出力： ランク、URL、タイトル、説明、ドメイン、リッチスニペット、AI 概要参照、People Also Ask。

/seo dataforseo serp-youtube <keyword>

YouTube 検索結果を取得。GEO に価値があります。YouTube 言及は AI 引用と最も強く相関します。

MCP ツール： serp_youtube_organic_live_advanced

出力： ビデオ タイトル、チャンネル、再生数、アップロード日、説明、URL。

/seo dataforseo youtube <video_id>

特定の YouTube ビデオの詳細分析：情報、コメント、字幕。YouTube 言及は AI 可視性（0.737）との相関が最も強く、GEO 分析に重要です。

MCP ツール： serp_youtube_video_info_live_advanced、serp_youtube_video_comments_live_advanced、serp_youtube_video_subtitles_live_advanced

パラメータ： video_id（YouTube ビデオ ID、例："dQw4w9WgXcQ"）

出力： ビデオ メタデータ（タイトル、チャンネル、再生数、高く評価された数、説明）、エンゲージメント付きの主要コメント、字幕/トランスクリプト テキスト。

/seo dataforseo serp-images <keyword>

ライブ Google Images 検索結果を取得。キーワードのランク付け画像を確認し、どのドメインが画像結果を支配しているか、ビジュアル コンテンツの機会を特定します。

MCP ツール： serp_google_images_live_advanced

デフォルト パラメータ： location_code=2840（US）、language_code=en、device=desktop、depth=100

パラメータ： keyword（必須）、depth（オプション、最大 700、100 結果ごとに請求）、search_param（オプション、例："site:example.com"）

コスト警告： site: または filetype: オペレータを使用すると 5 倍の API コスト が発生します。フィルタリングされたクエリを実行する前にユーザーに警告してください。

出力： 位置、タイトル、alt テキスト、ソース ページ URL、直接画像 URL、ドメイン、エンコードされた URL。

提供する分析：

• ドメイン支配度：最も多くの画像位置を所有しているサイト（位置数の上位 10 ドメイン）
• Alt テキスト パターン：上位ランク付け画像の一般的なタイトル/alt テキスト パターン
• 形式分布：上位結果の WebP 対 JPEG 対 PNG（image_url 拡張子から推測）
• 機会識別：オーガニック ランキングがあるがイメージ表示がないキーワード

---

キーワード調査

/seo dataforseo keywords <seed>

シード キーワードからキーワード アイデア、提案、関連用語を生成。

MCP ツール： dataforseo_labs_google_keyword_ideas、dataforseo_labs_google_keyword_suggestions、dataforseo_labs_google_related_keywords

デフォルト パラメータ： location_code=2840（US）、language_code=en、limit=50

出力： キーワード、検索ボリューム、CPC、競合レベル、キーワード難易度、トレンド。

/seo dataforseo volume <keywords>

キーワード リストの検索ボリュームと指標を取得。

MCP ツール： kw_data_google_ads_search_volume

パラメータ： keywords（配列、カンマ区切り）、location_code、language_code

出力： キーワード、月間検索ボリューム、CPC、競合、月間トレンド データ。

/seo dataforseo difficulty <keywords>

ランキング競争力のためのキーワード難易度スコアを計算。

MCP ツール： dataforseo_labs_bulk_keyword_difficulty

パラメータ： keywords（配列）、location_code、language_code

出力： キーワード、難易度スコア（0-100）、解釈（Easy/Medium/Hard/Very Hard）。

/seo dataforseo intent <keywords>

ユーザー検索意図によるキーワードの分類。

MCP ツール： dataforseo_labs_search_intent

パラメータ： keywords（配列）、location_code、language_code

出力： キーワード、意図タイプ（情報収集、ナビゲーション、商業、トランザクション）、信頼スコア。

/seo dataforseo trends <keyword>

Google トレンド データを使用してキーワード トレンドを時系列で分析。

MCP ツール： kw_data_google_trends_explore

パラメータ： keywords（配列）、location_code、date_from、date_to、language_code

出力： キーワード、時系列データ、トレンド方向、季節性シグナル。

---

ドメイン & 競合分析

/seo dataforseo backlinks <domain>

包括的なバックリンク プロファイル分析。

MCP ツール： backlinks_summary、backlinks_backlinks、backlinks_anchors、backlinks_referring_domains、backlinks_bulk_spam_score、backlinks_timeseries_summary

デフォルト パラメータ： サブ呼び出しごとに limit=100

出力： 総バックリンク数、リファリング ドメイン、ドメイン ランク、スパム スコア、トップ アンカー、新規/失失バックリンク（時系列）、dofollow 比率、トップ リファリング ドメイン。

/seo dataforseo competitors <domain>

競合ドメインを特定しトラフィックを推定。

MCP ツール： dataforseo_labs_google_competitors_domain、dataforseo_labs_google_domain_rank_overview、dataforseo_labs_bulk_traffic_estimation

出力： 競合ドメイン、キーワード重複 %、推定トラフィック、ドメイン ランク、共通キーワード。

/seo dataforseo ranked <domain>

ドメインがランク付けされているキーワード、位置、ページ データをリスト。

MCP ツール： dataforseo_labs_google_ranked_keywords、dataforseo_labs_google_relevant_pages

デフォルト パラメータ： limit=100、location_code=2840

出力： キーワード、位置、URL、検索ボリューム、トラフィック シェア、SERP 機能。

/seo dataforseo intersection <domain1> <domain2> [...]

2-20 個のドメイン間で共有キーワードとバックリンク ソースを検索。

MCP ツール： dataforseo_labs_google_domain_intersection、backlinks_domain_intersection

パラメータ： domains（2-20 配列）

出力： ドメインごとの位置付き共有キーワード、共有バックリンク ソース、ドメインごとの一意なキーワード。

/seo dataforseo traffic <domains>

1 つ以上のドメインのオーガニック検索トラフィックを推定。

MCP ツール： dataforseo_labs_bulk_traffic_estimation

パラメータ： domains（配列）

出力： ドメイン、推定オーガニック トラフィック、推定トラフィック コスト、トップ キーワード。

/seo dataforseo subdomains <domain>

ランキング データとトラフィック推定を含むサブドメインを列挙。

MCP ツール： dataforseo_labs_google_subdomains

パラメータ： target（ドメイン）、location_code、language_code

出力： サブドメイン、ランク付けキーワード数、推定トラフィック、オーガニック コスト。

/seo dataforseo top-searches <domain>

特定のドメインが結果に記載される最も人気のある検索クエリを検索。

MCP ツール： dataforseo_labs_google_top_searches

パラメータ： target（ドメイン）、location_code、language_code

出力： クエリ、検索ボリューム、ドメイン位置、SERP 機能、トラフィック シェア。

---

テクニカル/オンページ

/seo dataforseo onpage <url>

Lighthouse 監査とコンテンツ解析を含むオンページ分析を実行。

MCP ツール： on_page_instant_pages、on_page_content_parsing、on_page_lighthouse

使用法：

• on_page_instant_pages：クイック ページ分析（ステータス コード、メタ タグ、コンテンツ サイズ、ページ タイミング、リンク切れ、オンページ チェック）
• on_page_content_parsing：ページ コンテンツの抽出と解析（プレーン テキスト、単語数、構造）
• on_page_lighthouse：完全な Lighthouse 監査（パフォーマンス スコア、アクセシビリティ、ベスト プラクティス、SEO、Core Web Vitals）

出力： クロール済みページ数、ステータス コード、メタ タグ、タイトル、コンテンツ サイズ、読み込み時間、Lighthouse スコア、リンク切れ、リソース分析。

/seo dataforseo tech <domain>

ドメインで使用されているテクノロジーを検出。

MCP ツール： domain_analytics_technologies_domain_technologies

出力： テクノロジー名、バージョン、カテゴリ（CMS、分析、CDN、フレームワークなど）。

/seo dataforseo whois <domain>

WHOIS 登録データを取得。

MCP ツール： domain_analytics_whois_overview

出力： レジストラ、作成日、有効期限、ネームサーバー、登録者情報（公開の場合）。

---

コンテンツ & ビジネス データ

/seo dataforseo content <keyword/url>

コンテンツ品質を分析し、トピック別のコンテンツを検索し、フレーズ トレンドを追跡。

MCP ツール： content_analysis_search、content_analysis_summary、content_analysis_phrase_trends

パラメータ： keyword（検索/トレンド用）または URL（サマリー用）

出力： 品質スコア付きコンテンツ マッチ、センチメント分析、可読性指標、フレーズ トレンド データ（時系列）。

/seo dataforseo listings <keyword>

ローカル SEO 競合分析のためにビジネスリスティングを検索。

MCP ツール： business_data_business_listings_search

パラメータ： keyword、location（オプション）

出力： ビジネス名、説明、カテゴリ、住所、電話、ドメイン、評価、レビュー数、認定ステータス。

---

AI 可視性 / GEO

/seo dataforseo ai-scrape <query>

ChatGPT ウェブ検索がクエリに対して返すものをスクレープ。リアル GEO 可視性チェック：ChatGPT がターゲット キーワードに対して引用するソースを確認。

MCP ツール： ai_optimization_chat_gpt_scraper

パラメータ： query、location_code（オプション）、language_code（オプション）。ai_optimization_chat_gpt_scraper_locations を使用して利用可能な場所を検索。

出力： ChatGPT レスポンス コンテンツ、引用ソース/URL、参照ドメイン。

/seo dataforseo ai-mentions <keyword>

LLM がブランド、ドメイン、トピックをどのように言及しているかを追跡。GEO に重要。複数の LLM プラットフォーム間での実際の AI 可視性を測定。

MCP ツール： ai_opt_llm_ment_search、ai_opt_llm_ment_top_domains、ai_opt_llm_ment_top_pages、ai_opt_llm_ment_agg_metrics

パラメータ： keyword、location_code（オプション）、language_code（オプション）。ai_opt_llm_ment_loc_and_lang で利用可能な場所/言語、ai_optimization_llm_models で対応 LLM モデルを確認。

ワークフロー：

1. ai_opt_llm_ment_search で LLM 言及を検索（LLM レスポンス全体でブランド/キーワードの言及を検索）
2. ai_opt_llm_ment_top_domains でトップ引用ドメインを取得（このトピックで最も引用されているドメイン）
3. ai_opt_llm_ment_top_pages でトップ引用ページを取得（最も引用されている特定ページ）
4. ai_opt_llm_ment_agg_metrics で集計指標を取得（全体的な言及ボリューム、トレンド）

出力： LLM 言及数、頻度付きトップ引用ドメイン、トップ引用ページ、言及トレンド（時系列）、クロス プラットフォーム可視性スコア。

高度な使用： ChatGPT、Claude、Perplexity などプラットフォーム間で言及がどのように異なるかについて、クロスモデル比較の場合は ai_opt_llm_ment_cross_agg_metrics を使用。

---

利用可能なユーティリティ ツール

追加の DataForSEO MCP ツールは内部使用のために利用可能ですが、専用コマンドはありません。特定のユーティリティ ツール（場所参照、一括操作、履歴データ、フィルタオプション）を検索する必要がある場合は references/tool-catalog.md を読み込んでください。

クロス スキル統合

DataForSEO MCP ツールが利用可能な場合、他の claude-seo スキルはライブ データを活用できます：

• seo-audit：実際の SERP、バックリンク、オンページ、リスティング データのために seo-dataforseo エージェントをスポーン
• seo-technical：実際のクロール データのために on_page_instant_pages / on_page_lighthouse を使用、スタック検出のために domain_analytics_technologies_domain_technologies を使用
• seo-content：実際のキーワード指標のために kw_data_google_ads_search_volume、dataforseo_labs_bulk_keyword_difficulty、dataforseo_labs_search_intent を使用、コンテンツ品質のために content_analysis_summary を使用
• seo-page：実際の SERP 位置のために serp_organic_live_advanced を使用、リンク データのために backlinks_summary を使用
• seo-images：競合画像 SERP データのために serp_google_images_live_advanced を使用、オンページ画像監査とクロス参照
• seo-geo：実際の ChatGPT 可視性のために ai_optimization_chat_gpt_scraper を使用、LLM 言及追跡のために ai_opt_llm_ment_search を使用
• seo-plan：実際の競合インテリジェンスのために dataforseo_labs_google_competitors_domain、dataforseo_labs_google_domain_intersection、dataforseo_labs_bulk_traffic_estimation を使用

エラー ハンドリング

• MCP サーバーが接続されていない：DataForSEO 拡張機能がインストールされていないか、MCP サーバーに接続できないことを報告。./extensions/dataforseo/install.sh の実行を提案
• API 認証失敗：認証情報が無効であることを報告。MCP 設定で DataForSEO API ログイン/パスワードを確認するよう提案
• レート制限超過：ヒットしたリミットを報告し、再試行前に待つよう提案
• 結果が返されない：推測するのではなく、クエリに対して「データが見つかりません」と報告。クエリを広げるか、location_code/language_code を確認するよう提案
• 無効な location_code：エラーを報告し、locations 参照ツールを使用して正しいコードを見つけるよう提案

出力形式

既存の claude-seo 出力パターンに一致させてください：

• 比較データの場合はテーブルを使用
• 問題を Critical > High > Medium > Low として優先順位付け
• 具体的で実行可能な推奨事項を含める
• スコアを適用可能な場所では XX/100 として表示
• 静的分析と区別するために、データ ソースを「DataForSEO（ライブ）」と記載