seo-dataforseo

seo-dataforseo

热门

通过 DataForSEO MCP 服务器获取实时 SEO 数据:SERP 分析、关键词研究(搜索量、难度、意图、趋势)、外链概况、页面分析、竞争对手和内容分析、商家列表、AI 可见性(LLM 提及追踪)以及域名分析。需要安装 DataForSEO 扩展。当用户提到“dataforseo”、“实时 SERP”、“关键词搜索量”、“外链数据”、“AI 可见性检查”或“真实搜索数据”时使用。

1.2万Star
1781Fork
更新于 2026/7/20
SKILL.md
readonly只读
name
seo-dataforseo
description

通过 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_advancedserp_youtube_video_comments_live_advancedserp_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_ideasdataforseo_labs_google_keyword_suggestionsdataforseo_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_summarybacklinks_backlinksbacklinks_anchorsbacklinks_referring_domainsbacklinks_bulk_spam_scorebacklinks_timeseries_summary

默认参数: 每次子调用 limit=100

输出: 总外链数、引用域名数、域名排名、垃圾评分、热门锚文本、新增/丢失外链随时间变化、dofollow 比例、热门引用域名。

/seo dataforseo competitors <domain>

识别竞争域名并估算流量。

MCP 工具: dataforseo_labs_google_competitors_domaindataforseo_labs_google_domain_rank_overviewdataforseo_labs_bulk_traffic_estimation

输出: 竞争域名、关键词重叠百分比、估算流量、域名排名、共同关键词。

/seo dataforseo ranked <domain>

列出域名排名的关键词及其位置和页面数据。

MCP 工具: dataforseo_labs_google_ranked_keywordsdataforseo_labs_google_relevant_pages

默认参数: limit=100,location_code=2840

输出: 关键词、位置、URL、搜索量、流量份额、SERP 特性。

/seo dataforseo intersection <domain1> <domain2> [...]

查找 2-20 个域名之间的共享关键词和外链来源。

MCP 工具: dataforseo_labs_google_domain_intersectionbacklinks_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_pageson_page_content_parsingon_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_searchcontent_analysis_summarycontent_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_searchai_opt_llm_ment_top_domainsai_opt_llm_ment_top_pagesai_opt_llm_ment_agg_metrics

参数: keyword,location_code(可选),language_code(可选)。使用 ai_opt_llm_ment_loc_and_lang 获取可用位置/语言,使用 ai_optimization_llm_models 获取支持的 LLM 模型。

工作流程:

  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:生成 seo-dataforseo 代理以获取实时 SERP、外链、页面和列表数据
  • seo-technical:使用 on_page_instant_pages / on_page_lighthouse 获取实时抓取数据,使用 domain_analytics_technologies_domain_technologies 进行技术栈检测
  • seo-content:使用 kw_data_google_ads_search_volumedataforseo_labs_bulk_keyword_difficultydataforseo_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_domaindataforseo_labs_google_domain_intersectiondataforseo_labs_bulk_traffic_estimation 获取实时竞争情报

错误处理

  • MCP 服务器未连接:报告 DataForSEO 扩展未安装或 MCP 服务器不可达。建议运行 ./extensions/dataforseo/install.sh
  • API 认证失败:报告凭据无效。建议检查 MCP 配置中的 DataForSEO API 登录名/密码
  • 超出速率限制:报告已达到限制,建议等待后重试
  • 无结果返回:报告“未找到数据”,而不是猜测。建议扩大查询范围或检查位置/语言代码
  • 无效的位置代码:报告错误,建议使用位置查询工具查找正确代码

输出格式

匹配现有 claude-seo 输出模式:

  • 使用表格展示对比数据
  • 按严重程度排序:严重 > 高 > 中 > 低
  • 包含具体、可操作的建议
  • 在适用时显示 XX/100 的评分
  • 注明数据来源为“DataForSEO(实时)”,以区别于静态分析