seo-dataforseo

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を呼び出す前に毎回、コストを見積もってください。

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check <endpoint> [--count N]

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

各API呼び出しの完了後、コストを記録してください。

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-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画像検索ツールがありません）
/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 Overview の参照、他の人はこちらも質問。

/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 サーバーには Google 画像検索ツールがないため、完全な画像検索結果ではありません）。どの画像が表示されているか、どのドメインが大半を占めているかを確認し、ビジュアルコンテンツの機会を特定します。

MCP ツール： なし。固定された [email protected] には Google 画像検索結果ツールがありません（パッケージを 2026-09-23 に確認）。画像検索結果データは MCP 経由では利用できないと伝え、その名前のツールは決して呼び出さないでください。serp_organic_live_advanced の結果に images 要素が含まれている場合、それが最も近い代替手段です。

デフォルトパラメーター： 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

パラメーター： キーワード（検索／トレンド用）または URL（要約用）

出力： 品質スコア、センチメント分析、可読性指標、経時的なフレーズのトレンドデータを含む、条件に一致したコンテンツ。

/seo dataforseo listings <keyword>

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

MCP ツール： business_data_business_listings_search

パラメーター： キーワード、地域（任意）

出力： ビジネス名、説明、カテゴリ、住所、電話番号、ドメイン、評価、レビュー数、オーナー確認済みかどうか。

---

AI での可視性／GEO

/seo dataforseo ai-scrape <query>

クエリに対する ChatGPT のウェブ検索結果をスクレイピングします。ChatGPT での可視性を確認し、ターゲットキーワードについて ChatGPT が引用しているソースを調べます。利用可能な場合は、GSC の生成 AI レポートで Google AI Overviews と AI Mode を確認します。

MCP ツール： ai_optimization_chat_gpt_scraper

パラメーター： クエリ、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

パラメーター： キーワード、location_code（任意）、language_code（任意）。利用可能な地域と言語には 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 ツールは内部利用向けに提供されていますが、専用コマンドはありません。特定のユーティリティツール（地域の検索、一括操作、履歴データ、フィルターオプション）を見つける必要がある場合は、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：固定された MCP サーバーには Google 画像 SERP ツールがありません。serp_organic_live_advanced の images 要素があれば、オンページの画像監査と照合して使用します
• 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 のログイン名とパスワードを確認するよう提案します
• レート制限を超過した：制限に達したことを報告し、再試行の前に待つよう提案します
• 結果が返されない：推測せず、クエリに対して「データが見つかりませんでした」と報告します。クエリの範囲を広げるか、地域コード／言語コードを確認するよう提案します
• 地域コードが無効：エラーを報告し、正しいコードを見つけるために地域検索ツールを使用するよう提案します

出力形式

既存の claude-seo の出力形式に合わせます。

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