DataForSEO：即時 SEO 資料（擴充功能）
透過 DataForSEO MCP 伺服器取得即時搜尋資料。提供即時 SERP 結果 （自然搜尋 + 圖片）、關鍵字指標、反向連結資料、頁面分析、內容 分析、商家資訊、AI 可見度檢查以及 LLM 提及追蹤，涵蓋 9 個 API 模組和超過 79 個 MCP 工具。
先決條件
此技能需要安裝 DataForSEO 擴充功能：
./extensions/dataforseo/install.sh
可用性檢查： 在使用任何 DataForSEO 工具之前，請驗證 MCP 伺服器
是否已連線，檢查 serp_organic_live_advanced 或任何 DataForSEO 工具
是否可用。如果工具不可用，請告知使用者擴充功能尚未安裝，並提供安裝說明。
API 點數注意事項
DataForSEO 按每次 API 呼叫收費。請有效率地使用：
- 優先使用批次端點而非多次單一呼叫
- 除非使用者特別指定，否則使用預設參數（美國、英文）
- 在同一工作階段內快取結果；不要重複取得相同資料
- 在執行昂貴的操作（完整反向連結爬取、大量關鍵字列表）前，先警告使用者
成本控管機制
在每次 DataForSEO MCP 呼叫前，執行成本估算：
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py check <端點> [--count N]
- 如果
"status": "approved"→ 繼續進行 API 呼叫 - 如果
"status": "needs_approval"→ 向使用者顯示成本估算，並在繼續前徵得同意 - 如果
"status": "blocked"→ 告知使用者已超過每日預算限制；請勿繼續
在每次 API 呼叫完成後，記錄成本：
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py log <端點> <實際成本>
使用者成本管理指令：
$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 <關鍵字> | Google 自然搜尋 SERP 結果 |
$seo dataforseo serp-images <關鍵字> | 自然搜尋 SERP 中的圖片元素（固定的 MCP 伺服器沒有 Google 圖片工具） |
$seo dataforseo serp-youtube <關鍵字> | YouTube 搜尋結果 |
$seo dataforseo youtube <影片ID> | YouTube 影片深度分析 |
$seo dataforseo keywords <種子關鍵字> | 關鍵字想法和建議 |
$seo dataforseo volume <關鍵字> | 關鍵字搜尋量 |
$seo dataforseo difficulty <關鍵字> | 關鍵字難度分數 |
$seo dataforseo intent <關鍵字> | 搜尋意圖分類 |
$seo dataforseo trends <關鍵字> | Google 趨勢資料 |
$seo dataforseo backlinks <網域> | 完整反向連結資料 |
$seo dataforseo competitors <網域> | 競爭對手網域分析 |
$seo dataforseo ranked <網域> | 網域的排名關鍵字 |
$seo dataforseo intersection <網域> | 關鍵字/反向連結重疊 |
$seo dataforseo traffic <網域> | 大量流量估算 |
$seo dataforseo subdomains <網域> | 含排名資料的子網域 |
$seo dataforseo top-searches <網域> | 提及網域的最熱門查詢 |
$seo dataforseo onpage <網址> | 頁面分析（Lighthouse + 解析） |
$seo dataforseo tech <網域> | 技術堆疊偵測 |
$seo dataforseo whois <網域> | WHOIS 註冊資料 |
$seo dataforseo content <關鍵字/網址> | 內容分析與趨勢 |
$seo dataforseo listings <關鍵字> | 商家資訊搜尋 |
$seo dataforseo ai-scrape <查詢> | 用於 GEO 的 ChatGPT 網頁抓取器 |
$seo dataforseo ai-mentions <關鍵字> | 用於 GEO 的 LLM 提及追蹤 |
SERP 分析
$seo dataforseo serp <關鍵字>
取得即時 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" 可切換搜尋引擎。
輸出： 排名、網址、標題、描述、網域、精選摘要、AI 概述參考、其他人也問。
$seo dataforseo serp-youtube <關鍵字>
取得 YouTube 搜尋結果。對 GEO 很有價值。YouTube 提及與 AI 引用之間的關聯最強。
MCP 工具： serp_youtube_organic_live_advanced
輸出： 影片標題、頻道、觀看次數、上傳日期、描述、網址。
$seo dataforseo youtube <影片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 <關鍵字>
報告 Google 在特定關鍵字的自然搜尋結果中顯示的圖片元素（固定的 MCP 伺服器沒有 Google 圖片工具，因此這不是完整的圖片 SERP）。查看哪些圖片出現、哪些網域主導這些圖片，以及識別 視覺內容機會。
MCP 工具： 無。固定的 [email protected] 沒有暴露
任何 Google 圖片 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: 運算子會產生 5 倍 API 成本。在執行過濾查詢前先警告使用者。
輸出： 位置、標題、替代文字、來源頁面網址、直接圖片網址、網域、編碼網址。
要提供的分析：
- 網域主導性：哪些網站擁有最多圖片位置（依計數排序前 10 名網域）
- 替代文字模式：排名靠前圖片中的常見標題/替代文字模式
- 格式分佈：WebP 與 JPEG 與 PNG 在頂部結果中的比例（從 image_url 副檔名推斷）
- 機會識別：使用者有自然排名但沒有圖片出現的關鍵字
關鍵字研究
$seo dataforseo keywords <種子關鍵字>
從一個種子關鍵字產生關鍵字想法、建議和相關詞彙。
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 <關鍵字>
取得一系列關鍵字的搜尋量和指標。
MCP 工具： kw_data_google_ads_search_volume
參數： keywords（陣列，以逗號分隔），location_code，language_code
輸出： 關鍵字、每月搜尋量、CPC、競爭程度、每月趨勢資料。
$seo dataforseo difficulty <關鍵字>
計算關鍵字難度分數以評估排名競爭力。
MCP 工具： dataforseo_labs_bulk_keyword_difficulty
參數： keywords（陣列），location_code，language_code
輸出： 關鍵字、難度分數（0-100）、解讀（容易/中等/困難/非常困難）。
$seo dataforseo intent <關鍵字>
按使用者搜尋意圖分類關鍵字。
MCP 工具： dataforseo_labs_search_intent
參數： keywords（陣列），location_code，language_code
輸出： 關鍵字、意圖類型（資訊性、導航性、商業性、交易性）、信心分數。
$seo dataforseo trends <關鍵字>
使用 Google 趨勢資料分析關鍵字隨時間的變化趨勢。
MCP 工具： kw_data_google_trends_explore
參數： keywords（陣列），location_code，date_from，date_to，language_code
輸出： 關鍵字、時間序列資料、趨勢方向、季節性訊號。
網域與競爭者分析
$seo dataforseo backlinks <網域>
全面的反向連結資料分析。
MCP 工具： backlinks_summary， backlinks_backlinks， backlinks_anchors， backlinks_referring_domains， backlinks_bulk_spam_score， backlinks_timeseries_summary
預設參數： limit=100（每次子呼叫）
輸出： 總反向連結數、參照網域數、網域權重、垃圾郵件分數、主要錨點文字、隨時間新增/遺失的反向連結、dofollow 比例、主要參照網域。
$seo dataforseo competitors <網域>
識別競爭網域並估算流量。
MCP 工具： dataforseo_labs_google_competitors_domain， dataforseo_labs_google_domain_rank_overview， dataforseo_labs_bulk_traffic_estimation
輸出： 競爭網域、關鍵字重疊百分比、估算流量、網域排名、共同關鍵字。
$seo dataforseo ranked <網域>
列出網域排名所在的關鍵字，包含位置和頁面資料。
MCP 工具： dataforseo_labs_google_ranked_keywords， dataforseo_labs_google_relevant_pages
預設參數： limit=100，location_code=2840
輸出： 關鍵字、位置、網址、搜尋量、流量佔比、SERP 功能。
$seo dataforseo intersection <網域1> <網域2> [...]
在 2-20 個網域之間尋找共有關鍵字和反向連結來源。
MCP 工具： dataforseo_labs_google_domain_intersection， backlinks_domain_intersection
參數： domains（2-20 個網域組成的陣列）
輸出： 每個網域的共有關鍵字（含位置）、共有的反向連結來源、每個網域的獨特關鍵字。
$seo dataforseo traffic <網域>
估算一個或多個網域的自然搜尋流量。
MCP 工具： dataforseo_labs_bulk_traffic_estimation
參數： domains（陣列）
輸出： 網域、估算自然流量、估算流量成本、主要關鍵字。
$seo dataforseo subdomains <網域>
列舉子網域及其排名資料和流量估算。
MCP 工具： dataforseo_labs_google_subdomains
參數： target（網域），location_code，language_code
輸出： 子網域、排名關鍵字數量、估算流量、自然流量成本。
$seo dataforseo top-searches <網域>
找出在搜尋結果中提及特定網域的最熱門搜尋查詢。
MCP 工具： dataforseo_labs_google_top_searches
參數： target（網域），location_code，language_code
輸出： 查詢、搜尋量、網域位置、SERP 功能、流量佔比。
技術 / 頁面層面分析
$seo dataforseo onpage <網址>
執行頁面分析，包括 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 <網域>
偵測網域使用的技術。
MCP 工具： domain_analytics_technologies_domain_technologies
輸出： 技術名稱、版本、類別（CMS、分析、CDN、框架等）。
$seo dataforseo whois <網域>
取得 WHOIS 註冊資料。
MCP 工具： domain_analytics_whois_overview
輸出： 註冊商、建立日期、到期日期、名稱伺服器、註冊人資訊（如果為公開）。
內容與商業資料
$seo dataforseo content <關鍵字/網址>
分析內容品質、依主題搜尋內容，以及追蹤詞組趨勢。
MCP 工具： content_analysis_search， content_analysis_summary， content_analysis_phrase_trends
參數： keyword（用於搜尋/趨勢）或 URL（用於摘要）
輸出： 符合條件的內容（含品質分數）、情感分析、可讀性指標、隨時間變化的詞組趨勢資料。
$seo dataforseo listings <關鍵字>
搜尋商家資訊以進行在地 SEO 競爭分析。
MCP 工具： business_data_business_listings_search
參數： keyword，location（選填）
輸出： 商家名稱、描述、類別、地址、電話、網域、評分、評論數、是否已認領。
AI 可見度 / GEO
$seo dataforseo ai-scrape <查詢>
抓取 ChatGPT 網頁搜尋對某個查詢的回應。ChatGPT 可見度檢查：查看 ChatGPT 為您的目標關鍵字引用了哪些來源。當可用時，請使用 GSC 生成式 AI 報告檢查 Google AI 概覽和 AI 模式。
MCP 工具： ai_optimization_chat_gpt_scraper
參數： query，location_code（選填），language_code（選填）。使用 ai_optimization_chat_gpt_scraper_locations 查詢可用的地理位置。
輸出： ChatGPT 回應內容、引用的來源/網址、提及的網域。
$seo dataforseo ai-mentions <關鍵字>
追蹤 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 模型。
工作流程：
- 使用
ai_opt_llm_ment_search搜尋 LLM 提及（在 LLM 回應中尋找品牌/關鍵字的提及） - 取得熱門引用