DataForSEO: ライブSEOデータ（拡張機能）
DataForSEO MCPサーバーを介したライブ検索データ。オーガニック＋画像のリアルタイムSERP結果、キーワードメトリクス、バックリンクプロファイル、オンページ分析、コンテンツ分析、ビジネスリスティング、AI可視性チェック、LLMメンション追跡を、9つのAPIモジュールと79以上のMCPツールで提供します。
前提条件
このスキルを使用するには、DataForSEO拡張機能をインストールする必要があります：
./extensions/dataforseo/install.sh
利用可能性の確認： DataForSEOツールを使用する前に、serp_organic_live_advanced または任意のDataForSEOツールが利用可能かどうかを確認して、MCPサーバーが接続されていることを確認してください。ツールが利用できない場合は、拡張機能がインストールされていないことをユーザーに伝え、インストール手順を提供してください。
APIクレジットに関する注意
DataForSEOはAPI呼び出しごとに課金されます。効率的に使用してください：
- 複数の単一呼び出しよりも、バルクエンドポイントを優先する
- ユーザーが特に指定しない限り、デフォルトパラメータ（米国、英語）を使用する
- セッション内で結果を記憶し、同じデータを再取得しない
- 高コストな操作（フルバックリンククロール、大規模なキーワードリスト）を実行する前に、ユーザーに警告する
コストガードレール
DataForSEOのMCP呼び出しの前に、コスト見積もりを実行します：
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py check <endpoint> [--count N]
"status": "approved"の場合 → API呼び出しを続行します"status": "needs_approval"の場合 → ユーザーにコスト見積もりを表示し、続行前に確認を求めます"status": "blocked"の場合 → 1日の予算制限を超過することをユーザーに伝え、続行しないでください
各API呼び出しの完了後、コストを記録します：
"${CODEX_SEO_ROOT}/scripts/codex-seo" run 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> | オーガニックSERPからの画像要素（固定MCPサーバーにはGoogle Imagesツールはありません） |
$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> | GEOのためのChatGPTウェブスクレイパー |
$seo dataforseo ai-mentions <keyword> | GEOのためのLLMメンション追跡 |
SERP分析
$seo dataforseo serp <keyword>
ライブのGoogleオーガニック検索結果を取得します。
MCPツール： serp_organic_live_advanced
デフォルトパラメータ： location_code=2840（米国）、language_code=en、device=desktop、depth=100
対応エンジン： serp_organic_live_advanced ツールは、se パラメータを介してGoogle、Bing、Yahooをサポートしています。検索エンジンを切り替えるには、「bing」または「yahoo」を指定します。
出力： 順位、URL、タイトル、説明、ドメイン、注目スニペット、AI概要参照、「他の人はこちらも質問」。
$seo dataforseo serp-youtube <keyword>
YouTubeの検索結果を取得します。GEOにとって貴重です。YouTubeでのメンションは、AIによる引用と最も強く相関します。
MCPツール： serp_youtube_organic_live_advanced
出力： 動画タイトル、チャンネル、再生回数、アップロード日、説明、URL。
$seo dataforseo youtube <video_id>
特定のYouTube動画の詳細分析：情報、コメント、字幕。YouTubeメンションは有用なGEOシグナルとして扱いますが、AI可視性の相関関係は手法に依存します。
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がオーガニック結果で表示する画像要素をレポートします（固定MCPサーバーにはGoogle Imagesツールがないため、これは完全な画像SERPではありません）。どの画像が表示され、どのドメインがそれらを支配しているかを確認し、ビジュアルコンテンツの機会を特定します。
MCPツール： なし。固定の [email protected] はGoogle Images SERPツールを公開していません（パッケージを確認済み、2026-09-23）。画像SERPデータはMCPでは利用できないと伝え、その名前のツールを決して呼び出さないでください。serp_organic_live_advanced の結果に images 要素が存在する場合、それが最も近い代替手段です。
デフォルトパラメータ： location_code=2840（米国）、language_code=en、device=desktop、depth=100
パラメータ： keyword（必須）、depth（オプション、最大700、100結果単位で課金）、search_param（オプション、例：「site:example.com」）
コスト警告： site: または filetype: 演算子を使用すると、APIコストが5倍になります。フィルタリングされたクエリを実行する前にユーザーに警告してください。
出力： 順位、タイトル、altテキスト、ソースページURL、直接画像URL、ドメイン、エンコードされたURL。
提供する分析：
- ドメイン支配：どのサイトが最も多くの画像ポジションを占めているか（カウント順トップ10ドメイン）
- Altテキストパターン：上位ランクの画像に見られる一般的なタイトル/altテキストパターン
- フォーマット分布：上位結果におけるWebP vs JPEG vs 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（米国）、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）、解釈（簡単/中程度/難しい/非常に難しい）。
$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（サブコールごと）
出力： 総バックリンク数、参照ドメイン数、ドメインランク、スパムスコア、トップアンカー、経時的な新規/喪失バックリンク、nofollow/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ウェブ検索がクエリに対して返す内容をスクレイピングします。ChatGPT可視性チェック：ChatGPTがターゲットキーワードに対してどのソースを引用しているかを確認します。利用可能な場合は、Google AI OverviewsとAI ModeをGSC gen-AIレポートで確認してください。
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 を、サポートされているLLMモデルを確認するには ai_optimization_llm_models を使用します。
ワークフロー：
ai_opt_llm_ment_searchでLLMメンションを検索（LLM応答全体でのブランド/キーワードのメンションを検出）ai_opt_llm_ment_top_domainsでトップドメインを取得（最も頻繁に言及されているドメインを特定）ai_opt_llm_ment_top_pagesでトップページを取得（最も引用されているページを特定）ai_opt_llm_ment_agg_metricsで集計メトリクスを取得（ブランドの全体的な可視性スコアを取得）
出力： LLMメンション（LLM名、コンテキスト、頻度）、トップドメインとページ、ブランド可視性スコア、競合ベンチマーク。