seo-dataforseo

DataForSEO：实时 SEO 数据（扩展）

通过 DataForSEO MCP 服务获取实时搜索数据。提供实时 SERP 结果 （自然搜索结果 + 图片）、关键词指标、反向链接档案、页面分析、内容 分析、商家列表、AI 可见性检查，以及跨 9 个 API 模块的 LLM 提及追踪， 包含 79+ 个 MCP 工具。

前提条件

此技能需要安装 DataForSEO 扩展：

./extensions/dataforseo/install.sh

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

API 额度注意事项

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

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

成本限制

每次调用 DataForSEO MCP 前，都要运行成本估算：

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check <endpoint> [--count N]

• 如果 "status": "approved" → 继续进行 API 调用
• 如果 "status": "needs_approval" → 向用户显示成本估算，并在继续前征求确认
• 如果 "status": "blocked" → 告知用户这会超出每日预算上限；请勿继续

每次 API 调用完成后，记录成本：

"${CLAUDE_PLUGIN_ROOT}/scripts/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>	自然搜索 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 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

还支持： serp_organic_live_advanced 工具可通过 se 参数支持 Google、Bing 和 Yahoo。指定 "bing" 或 "yahoo" 即可切换搜索引擎。

输出： 排名、URL、标题、描述、域名、精选摘要、AI 概览引用、「其他人也在问」问题。

/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 服务没有 Google 图片搜索工具，因此这并非完整的图片 SERP）。查看哪些图片会出现、哪些域名占主导地位，并找出视觉内容机会。

MCP 工具： 无。已固定的 [email protected] 未提供 Google 图片 SERP 工具（已于 2026-09-23 检查该软件包）。请说明无法通过 MCP 获取图片 SERP 数据，绝不要调用该名称的工具；如果 serp_organic_live_advanced 结果中有 images 元素，则它是最接近的替代数据。

默认参数： location_code=2840 (US), 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 分布（根据 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 (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

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

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

/seo dataforseo listings <keyword>

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

MCP 工具： business_data_business_listings_search

参数： 关键词、位置（可选）

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

---

AI 可见度 / GEO

/seo dataforseo ai-scrape <query>

抓取 ChatGPT 网页搜索针对某个查询返回的结果。检查 ChatGPT 可见度：查看 ChatGPT 为目标关键词引用了哪些来源。可用时，使用 GSC 生成式 AI 报告检查 Google AI Overviews 和 AI Mode。

MCP 工具： ai_optimization_chat_gpt_scraper

参数： 查询、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

参数： 关键词、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 MCP 工具可供内部使用，但没有专用命令。需要查找特定实用工具（位置查询、批量操作、历史数据、筛选选项）时，请加载 references/tool-catalog.md。

跨技能集成

当 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-images：固定版本的 MCP 服务上没有 Google 图片 SERP 工具；使用 serp_organic_live_advanced 中的任意 images 元素，并与页面内图片审计结果交叉核对
• seo-geo：使用 ai_optimization_chat_gpt_scraper 获取真实的 ChatGPT 可见度，使用 ai_opt_llm_ment_search 跟踪大模型提及情况
• 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 输出模式：

• 使用表格展示比较数据
• 按 Critical > High > Medium > Low 对问题排序
• 提供具体、可执行的建议
• 在适用时以 XX/100 的形式显示分数
• 将数据源标注为 “DataForSEO（实时）”，以区别于静态分析