通过 DataForSEO MCP 服务器获取实时 SEO 数据:SERP 分析、关键词研究 (搜索量、难度、意图、趋势)、外链概况、页面分析、竞争对手和内容分析、 商家列表、AI 可见性(LLM 提及追踪)以及域名分析。需要安装 DataForSEO 扩展。当用户提到“dataforseo”、“实时 SERP”、“关键词搜索量”、“外链数据”、 “AI 可见性检查”或“真实搜索数据”时使用。
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 调用前,运行成本估算:
claude-seo run dataforseo_costs.py check <endpoint> [--count N]
- 如果
"status": "approved"→ 继续 API 调用 - 如果
"status": "needs_approval"→ 向用户显示成本估算,并在继续前请求确认 - 如果
"status": "blocked"→ 告知用户将超出每日预算限制;不要继续
每次 API 调用完成后,记录成本:
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> |
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> |
ChatGPT 网页抓取(用于 GEO) |
/seo dataforseo ai-mentions <keyword> |
LLM 提及追踪(用于 GEO) |
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 概览引用、People Also Ask。
/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(美国),language_code=en,device=desktop,depth=100
参数: keyword(必需),depth(可选,最大 700,每 100 个结果递增计费),search_param(可选,例如“site:example.com”)
费用警告: 使用 site: 或 filetype: 运算符会产生 5 倍 API 费用。在运行过滤查询前警告用户。
输出: 位置、标题、替代文本、来源页面 URL、直接图片 URL、域名、编码 URL。
分析提供:
- 域名主导:哪些网站拥有最多的图片位置(按数量排名前 10 的域名)
- 替代文本模式:排名靠前图片中的常见标题/替代文本模式
- 格式分布:WebP 与 JPEG 与 PNG 在顶部结果中的分布(从图片 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 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>
估算一个或多个域名的自然搜索流量。
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、核心 Web 指标)
输出: 抓取的页面、状态码、元标签、标题、内容大小、加载时间、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 为目标关键词引用了哪些来源。当可用时,通过 GSC gen-AI 报告检查 Google AI 概览和 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 获取可用位置/语言,使用 ai_optimization_llm_models 获取支持的 LLM 模型。
工作流程:
- 使用
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 提及次数、最常引用的域名及频率、最常引用的页面、提及趋势随时间变化、跨平台可见性评分。
高级: 使用 ai_opt_llm_ment_cross_agg_metrics 进行跨模型比较(提及在 ChatGPT、Claude、Perplexity 等之间的差异)。
可用实用工具
其他 DataForSEO MCP 工具可用于内部使用,但没有专用命令。当需要查找特定实用工具(位置查询、批量操作、历史数据、筛选选项)时,加载 references/tool-catalog.md。
跨技能集成
当 DataForSEO MCP 工具可用时,其他 claude-seo 技能可以利用实时数据:
- seo-audit:生成
seo-dataforseo代理以获取实时 SERP、外链、页面和列表数据 - 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_organic_live_advanced获取实时 SERP 位置,使用backlinks_summary获取链接数据 - seo-images:使用
serp_google_images_live_advanced获取竞争对手图片 SERP 数据,并与页面图片审计交叉引用 - seo-geo:使用
ai_optimization_chat_gpt_scraper获取实时 ChatGPT 可见性,使用ai_opt_llm_ment_search进行 LLM 提及追踪 - 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(实时)”,以区别于静态分析






