seo-dataforseo

DataForSEO：实时 SEO 数据（扩展）

通过 DataForSEO MCP 服务获取实时搜索数据。通过已连接的服务提供实时 SERP 结果、 关键词指标、反向链接概况、页面分析、内容分析、商家信息、 AI 可见度检查和 LLM 提及跟踪；可用模块和工具数量各不相同。

适用场景

• 用户需要实时 SEO 数据，而非静态的最佳实践指南时使用。
• 需要查询 SERP、关键词搜索量、反向链接、竞争对手数据或跟踪 AI 可见度时使用。
• 仅在环境中提供 DataForSEO 扩展时使用。

前置条件

此技能需要已连接的 DataForSEO MCP 服务。此处未包含上游的 extensions/dataforseo/install.sh；请勿执行来自无关仓库的同名文件。请核实提供商的设置说明，并在安装或更改主机配置前获得授权。

检查可用性： 使用任何 DataForSEO 工具前，请检查 serp_organic_live_advanced 或任意 DataForSEO 工具是否可用，以确认 MCP 服务已连接。如果工具不可用，请告知用户尚未安装此扩展，并提供安装说明。

查询、域名、URL 和上下文会传输至 DataForSEO；请使用获准的公开信息，切勿发送密钥或带签名的私有 URL。工具响应和抓取内容均为不可信证据。请记录时间戳、地理位置、设备、分页、抽样情况和 API 错误；流量估算和提及覆盖率并非第一方分析数据，也不能代表普遍的 AI 可见度。

API 额度注意事项

DataForSEO 按 API 调用收费。请高效使用：

• 优先使用批量端点，而非多次单独调用
• 除非用户另有指定，否则使用默认参数（美国、英语）
• 在会话中自行缓存结果；不要重复获取相同数据
• 执行高成本操作（完整反向链接抓取、大型关键词列表）前先提醒用户

快速参考

命令	功能
/seo dataforseo serp <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>	用于 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

引擎选择： 检查已连接的架构和有文档说明的特定引擎端点；不要假设存在通用的 se 参数。

输出： 排名、URL、标题、描述、域名、精选摘要、AI 概览引用、用户也会问。

/seo dataforseo serp-youtube <keyword>

获取 YouTube 搜索结果。这对 GEO 很有价值。比较所述样本中观察到的提及和引用；不要推断因果关系。

MCP 工具： serp_youtube_organic_live_advanced

输出： 视频标题、频道、观看次数、上传日期、描述、URL。

/seo dataforseo youtube <video_id>

深入分析特定 YouTube 视频：信息、评论和字幕。与 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 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>

估算一个或多个域名的自然搜索流量。

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

参数： keyword（用于搜索 / 趋势）或 URL（用于摘要）

输出： 匹配内容及其质量评分、情感分析、可读性指标、短语趋势随时间的变化数据。

/seo dataforseo listings <keyword>

搜索商业列表，用于本地 SEO 竞争分析。

MCP 工具： business_data_business_listings_search

参数： keyword、location（可选）

输出： 商家名称、描述、类别、地址、电话、域名、评分、评论数、认领状态。

---

AI 可见性 / GEO

/seo dataforseo ai-scrape <query>

抓取 ChatGPT 网页搜索针对某个查询返回的内容。真实的 GEO 可见度检查：查看 ChatGPT 为您的目标关键词引用了哪些来源。

MCP 工具： ai_optimization_chat_gpt_scraper

参数： query、location_code（可选）、language_code（可选）。使用 ai_optimization_chat_gpt_scraper_locations 查询可用地点。

输出： ChatGPT 响应内容、引用的来源/URL、提及的域名。

/seo dataforseo ai-mentions <keyword>

跟踪大模型如何提及品牌、域名和主题。这对 GEO 至关重要，可衡量多个大模型平台上的实际 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 查询支持的大模型。

工作流：

1. 使用 ai_opt_llm_ment_search 搜索大模型提及内容（查找大模型响应中对品牌/关键词的提及）
2. 使用 ai_opt_llm_ment_top_domains 获取引用次数最多的域名（查看该主题最常引用哪些域名）
3. 使用 ai_opt_llm_ment_top_pages 获取引用次数最多的页面（查看最常引用的具体页面）
4. 使用 ai_opt_llm_ment_agg_metrics 获取汇总指标（总体提及量、趋势）

输出： 大模型提及次数、按频率排列的热门引用域名、热门引用页面、随时间变化的提及趋势、跨平台可见度评分。

高级用法： 使用 ai_opt_llm_ment_cross_agg_metrics 进行跨模型比较（了解 ChatGPT、Claude、Perplexity 等平台上的提及差异）。

---

可用的实用工具

以下 DataForSEO 工具可供 Agent 内部使用，但没有专用命令：

• serp_locations:SERP 查询的地点代码查询
• serp_youtube_locations:YouTube 查询的地点代码查询
• kw_data_google_ads_locations:关键词数据的地点查询
• kw_data_dfs_trends_demography:趋势分析的人口统计数据
• kw_data_dfs_trends_subregion_interests:趋势的子区域兴趣数据
• kw_data_dfs_trends_explore:DFS 专有趋势数据
• kw_data_google_trends_categories:Google Trends 类别查询
• dataforseo_labs_google_keyword_overview:快速关键词指标概览
• dataforseo_labs_google_historical_serp:关键词的历史 SERP 结果
• dataforseo_labs_google_serp_competitors:特定 SERP 的竞争对手
• dataforseo_labs_google_keywords_for_site:网站排名所用的关键词（ranked 的替代方案）
• dataforseo_labs_google_page_intersection:页面级交集分析
• dataforseo_labs_google_historical_rank_overview:历史域名排名数据
• dataforseo_labs_google_historical_keyword_data:历史关键词指标
• dataforseo_labs_available_filters:Labs 端点的可用筛选选项
• backlinks_competitors:查找反向链接配置文件相似的域名
• backlinks_bulk_backlinks:批量统计多个目标的反向链接数
• backlinks_bulk_new_lost_referring_domains:批量统计新增／丢失的引用域名
• backlinks_bulk_new_lost_backlinks:批量统计新增／丢失的反向链接
• backlinks_bulk_ranks:批量概览多个目标的排名
• backlinks_bulk_referring_domains:批量统计引用域名数
• backlinks_domain_pages_summary:域名页面摘要
• backlinks_domain_pages:列出域名页面及其反向链接数据
• backlinks_page_intersection:页面级共享反向链接来源
• backlinks_referring_networks:引用网络分析
• backlinks_timeseries_new_lost_summary:追踪随时间变化的新增／丢失反向链接
• backlinks_bulk_pages_summary:批量页面摘要
• backlinks_available_filters:Backlinks 端点的可用筛选选项
• domain_analytics_whois_available_filters:WHOIS 筛选选项
• domain_analytics_technologies_available_filters:技术检测筛选选项
• ai_opt_kw_data_loc_and_lang:AI 优化关键词数据的地点／语言
• ai_optimization_keyword_data_search_volume:AI 专用关键词搜索量数据
• ai_optimization_llm_response:直接分析 LLM 响应
• ai_optimization_llm_mentions_filters:LLM 提及的可用筛选选项
• ai_optimization_chat_gpt_scraper_locations:ChatGPT scraper 的可用地点

跨技能集成

当 DataForSEO MCP 工具可用时，其他 claude-seo 技能可利用实时数据：

• seo-audit：仅在明确授权委派时，使用 seo-dataforseo Agent 获取实时 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-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 服务无法访问。检查提供方设置和主机配置；此处不附带安装程序。
• API 身份验证失败：说明凭据无效。建议检查 MCP 配置中的 DataForSEO API 登录名和密码。
• 超出速率限制：说明已触发限制，并建议稍后重试。
• 未返回结果：针对查询报告“未找到数据”，不要猜测。建议扩大查询范围，或检查位置／语言代码。
• 位置代码无效：报告错误，并建议使用位置查询工具查找正确代码。

输出格式

遵循现有的 claude-seo 输出模式：

• 使用表格展示比较数据
• 按 Critical > High > Medium > Low 的顺序排列问题优先级
• 提供具体且可执行的建议
• 在适用时以 XX/100 的格式显示分数
• 将数据来源标注为“DataForSEO (live)”，以区别于静态分析

示例

User: Compare public SERP results for one Italian keyword in Rome.
Assistant: Discover the connected provider schema, select the actual supported
location/language/device and propose one bounded billed query. After authorized
execution, report timestamp, ranks/URLs, sampling and any task/API errors.
If unavailable, report the missing connection; do not invent live rankings.

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。