seo-dataforseo

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 呼び出しごとに料金が発生します。効率的に利用してください。

• 複数の単一呼び出しより、一括エンドポイントを優先してください
• ユーザーから指定がない限り、デフォルトのパラメーター（米国、英語）を使用してください
• セッション内では結果を記憶してキャッシュし、同じデータを再取得しないでください
• 費用のかかる操作（バックリンクの全件クロール、大量のキーワードリストなど）を実行する前にユーザーに警告してください

コストのガードレール

DataForSEO MCP を呼び出す前に毎回、コストを見積もってください。

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

• "status": "approved" の場合 → API を呼び出します
• "status": "needs_approval" の場合 → コスト見積もりをユーザーに提示し、実行前に確認を求めます
• "status": "blocked" の場合 → 1 日の予算上限を超えることをユーザーに伝え、実行しないでください

各 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 画像検索の 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 Trends データ
/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 (US), 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 での言及は 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 画像検索の結果をリアルタイムで取得します。キーワードでどの画像が上位表示されるか、どのドメインが画像検索結果を占めているかを確認し、ビジュアルコンテンツの機会を特定します。

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: 演算子を使用すると、API コストが 5 倍になります。フィルターを適用したクエリを実行する前に、ユーザーに警告してください。

出力： 順位、タイトル、代替テキスト、掲載元ページの URL、画像の直接 URL、ドメイン、エンコード済み URL。

提供する分析：

• ドメインの占有状況：画像検索結果で最も多くの順位を占めるサイト（上位 10 ドメインを件数順に表示）
• 代替テキストの傾向：上位表示される画像に見られる、タイトル／代替テキストの一般的なパターン
• 形式の分布：上位の結果における 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）、評価（易しい／中程度／難しい／非常に難しい）。

/seo dataforseo intent <keywords>

ユーザーの検索意図に基づいてキーワードを分類します。

MCP ツール： dataforseo_labs_search_intent

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

出力： キーワード、検索意図の種類（情報収集、ナビゲーション、商用、取引）、信頼度スコア。

/seo dataforseo trends <keyword>

Google Trends のデータを使用して、キーワードの経時的なトレンドを分析します。

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（任意）。利用可能な location を調べるには、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（任意）。利用可能な location／language を調べるには ai_opt_llm_ment_loc_and_lang を、対応している LLM モデルを調べるには ai_optimization_llm_models を使用します。

ワークフロー：

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 の言及数、頻度付きの引用数上位ドメイン、引用数上位ページ、時系列の言及トレンド、プラットフォーム横断の可視性スコア。

高度な使い方： ai_opt_llm_ment_cross_agg_metrics を使用すると、モデル間の比較（ChatGPT、Claude、Perplexity などで言及がどのように異なるか）ができます。

---

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

追加の DataForSEO MCP ツールは内部利用向けに用意されていますが、専用のコマンドはありません。特定のユーティリティツール（location の検索、一括操作、過去データ、フィルターオプションなど）を探す必要がある場合は、references/tool-catalog.md を読み込んでください。

スキル間の連携

DataForSEO MCP ツールが利用できる場合、他の seo-skills スキルからライブデータを活用できます。

• 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 のログイン名とパスワードを確認するよう提案します。
• レート制限を超えました：制限に達したことを報告し、再試行する前に待つよう提案します。
• 結果が返されませんでした：推測せず、クエリに対して「データが見つかりません」と報告します。クエリの範囲を広げるか、地域／言語コードを確認するよう提案します。
• 無効な地域コードです：エラーを報告し、正しいコードを見つけるために地域検索ツールを使うよう提案します。

出力形式

既存の seo-skills の出力パターンに合わせます。

• 比較データには表を使用します。
• 問題の優先度は「重大」＞「高」＞「中」＞「低」の順にします。
• 具体的で実行可能な推奨事項を含めます。
• 該当する場合、スコアは XX/100 の形式で示します。
• 静的解析と区別できるよう、データソースを「DataForSEO (live)」と記載します。