DataForSEO：实时 SEO 数据（扩展）
通过 DataForSEO MCP 服务器获取实时搜索数据。提供实时 SERP 结果（自然搜索 + 图片）、关键词指标、外链概况、页面分析、内容分析、商家列表、AI 可见性检查以及跨 9 个 API 模块（包含 79+ 个 MCP 工具）的 LLM 提及追踪。
前提条件
此技能需要安装 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"→ 告知用户会超出每日预算上限；不要继续
每次 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 图片工具） |
$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" 可切换搜索引擎。
输出： 排名、网址、标题、描述、域名、精选摘要、AI 概述引用、用户还问了什么。
$seo dataforseo serp-youtube <keyword>
获取 YouTube 搜索结果。对 GEO 很有价值。YouTube 提及与 AI 引用的相关性最强。
MCP 工具： serp_youtube_organic_live_advanced
输出： 视频标题、频道、观看次数、上传日期、描述、网址。
$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 图片工具，因此这并非完整的图片 SERP）。查看哪些图片出现、哪些域名占据主导地位，并识别视觉内容机会。
MCP 工具： 无。已固定的 [email protected] 没有暴露任何 Google 图片 SERP 工具（经检查包确认，2026-09-23）。告知用户图片 SERP 数据不可用，且切勿调用该名称的工具；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 <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 比例、热门引用域名。
$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
输出： 关键词、位置、网址、搜索量、流量份额、SERP 特性。
$seo dataforseo intersection <domain1> <domain2> [...]
查找 2-20 个域名之间的共同关键词和外链来源。
MCP 工具： dataforseo_labs_google_domain_intersection、backlinks_domain_intersection
参数： domains（2-20 个元素的数组）
输出： 各域名的共同关键词及位置、共同外链来源、各域名的独有关键词。
$seo dataforseo traffic <domains>
估算一个或多个域名的自然搜索流量。
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、核心网页指标）
输出： 已爬取页面、状态码、元标签、标题、内容大小、加载时间、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 概览和 AI 模式（通过 GSC 生成式 AI 报告，当可用时）进行检查。
MCP 工具： ai_optimization_chat_gpt_scraper
参数： query、location_code（可选）、language_code（可选）。使用 ai_optimization_chat_gpt_scraper_locations 查询可用位置。
输出： ChatGPT 响应内容、引用的来源/网址、引用的域名。
$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 模型。
工作流程：
- 使用
ai_opt_llm_ment_search搜索 LLM 提及（在 LLM 响应中查找品牌/关键词的提及） - 获取热门引用的域名和页面