Back to Details

seo-dataforseo

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

DataForSEO: Live SEO Data (Extension)

DataForSEO：实时SEO数据（扩展）

Live search data via the DataForSEO MCP server. Provides real-time SERP results, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, AI visibility checking, and LLM mention tracking across 9 API modules with 79 MCP tools.
通过DataForSEO MCP服务器获取实时搜索数据。涵盖9个API模块、79个MCP工具，可提供实时SERP结果、关键词指标、反向链接档案、页面内分析、内容分析、企业列表、AI可见性检测以及LLM提及追踪功能。

Prerequisites

前置条件

This skill requires the DataForSEO extension to be installed:
bash
./extensions/dataforseo/install.sh
Check availability: Before using any DataForSEO tool, verify the MCP server is connected by checking if 
serp_organic_live_advanced
or any DataForSEO tool is available. If tools are not available, inform the user the extension is not installed and provide install instructions.
使用本功能需要安装DataForSEO扩展：
bash
./extensions/dataforseo/install.sh
检查可用性： 在使用任何DataForSEO工具前，请通过确认
serp_organic_live_advanced
或其他DataForSEO工具是否可用，来验证MCP服务器已连接。若工具不可用，请告知用户未安装扩展，并提供安装说明。

API Credit Awareness

API使用额度须知

DataForSEO charges per API call. Be efficient:
  • Prefer bulk endpoints over multiple single calls
  • Use default parameters (US, English) unless user specifies otherwise
  • Cache results mentally within a session; don't re-fetch the same data
  • Warn user before running expensive operations (full backlink crawls, large keyword lists)
DataForSEO按API调用次数收费，请高效使用：
  • 优先使用批量端点，而非多次单独调用
  • 除非用户指定，否则使用默认参数（美国、英文）
  • 在会话内缓存结果，避免重复获取相同数据
  • 在执行高消耗操作（完整反向链接爬取、大型关键词列表）前，先提醒用户

Quick Reference

快速参考

CommandWhat it does
/seo dataforseo serp <keyword>
Google organic SERP results
/seo dataforseo serp-youtube <keyword>
YouTube search results
/seo dataforseo youtube <video_id>
YouTube video deep analysis
/seo dataforseo keywords <seed>
Keyword ideas and suggestions
/seo dataforseo volume <keywords>
Search volume for keywords
/seo dataforseo difficulty <keywords>
Keyword difficulty scores
/seo dataforseo intent <keywords>
Search intent classification
/seo dataforseo trends <keyword>
Google Trends data
/seo dataforseo backlinks <domain>
Full backlink profile
/seo dataforseo competitors <domain>
Competitor domain analysis
/seo dataforseo ranked <domain>
Ranked keywords for domain
/seo dataforseo intersection <domains>
Keyword/backlink overlap
/seo dataforseo traffic <domains>
Bulk traffic estimation
/seo dataforseo subdomains <domain>
Subdomains with ranking data
/seo dataforseo top-searches <domain>
Top queries mentioning domain
/seo dataforseo onpage <url>
On-page analysis (Lighthouse + parsing)
/seo dataforseo tech <domain>
Technology stack detection
/seo dataforseo whois <domain>
WHOIS registration data
/seo dataforseo content <keyword/url>
Content analysis and trends
/seo dataforseo listings <keyword>
Business listings search
/seo dataforseo ai-scrape <query>
ChatGPT web scraper for GEO
/seo dataforseo ai-mentions <keyword>
LLM mention tracking for GEO
命令功能
/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>
ChatGPT网页抓取（用于GEO分析）
/seo dataforseo ai-mentions <keyword>
LLM提及追踪（用于GEO分析）

SERP Analysis

SERP分析

/seo dataforseo serp <keyword>

/seo dataforseo serp <keyword>

Fetch live Google organic search results.
MCP tools: 
serp_organic_live_advanced
Default parameters: location_code=2840 (US), language_code=en, device=desktop, depth=100
Also supports: The 
serp_organic_live_advanced
tool supports Google, Bing, and Yahoo via the 
se
parameter. Specify "bing" or "yahoo" to switch search engines.
Output: Rank, URL, title, description, domain, featured snippets, AI overview references, People Also Ask.
获取实时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>

/seo dataforseo serp-youtube <keyword>

Fetch YouTube search results. Valuable for GEO. YouTube mentions correlate most strongly with AI citations.
MCP tools: 
serp_youtube_organic_live_advanced
Output: Video title, channel, views, upload date, description, URL.
获取YouTube搜索结果。对GEO分析很有价值。YouTube提及量与AI引用相关性最强。
MCP工具： 
serp_youtube_organic_live_advanced
输出： 视频标题、频道、播放量、上传日期、描述、URL。

/seo dataforseo youtube <video_id>

/seo dataforseo youtube <video_id>

Deep analysis of a specific YouTube video: info, comments, and subtitles. YouTube mentions have the strongest correlation (0.737) with AI visibility, making this critical for GEO analysis.
MCP tools: 
serp_youtube_video_info_live_advanced
, 
serp_youtube_video_comments_live_advanced
, 
serp_youtube_video_subtitles_live_advanced
Parameters: video_id (the YouTube video ID, e.g., "dQw4w9WgXcQ")
Output: Video metadata (title, channel, views, likes, description), top comments with engagement, subtitle/transcript text.
对特定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”）
输出： 视频元数据（标题、频道、播放量、点赞数、描述）、高互动量热门评论、字幕/转录文本。

Keyword Research

关键词研究

/seo dataforseo keywords <seed>

/seo dataforseo keywords <seed>

Generate keyword ideas, suggestions, and related terms from a seed keyword.
MCP tools: 
dataforseo_labs_google_keyword_ideas
, 
dataforseo_labs_google_keyword_suggestions
, 
dataforseo_labs_google_related_keywords
Default parameters: location_code=2840 (US), language_code=en, limit=50
Output: Keyword, search volume, CPC, competition level, keyword difficulty, trend.
基于种子关键词生成关键词创意、建议及相关术语。
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>

/seo dataforseo volume <keywords>

Get search volume and metrics for a list of keywords.
MCP tools: 
kw_data_google_ads_search_volume
Parameters: keywords (array, comma-separated), location_code, language_code
Output: Keyword, monthly search volume, CPC, competition, monthly trend data.
获取关键词列表的搜索量及相关指标。
MCP工具： 
kw_data_google_ads_search_volume
参数： keywords（数组，逗号分隔）、location_code、language_code
输出： 关键词、月搜索量、CPC、竞争度、月度趋势数据。

/seo dataforseo difficulty <keywords>

/seo dataforseo difficulty <keywords>

Calculate keyword difficulty scores for ranking competitiveness.
MCP tools: 
dataforseo_labs_bulk_keyword_difficulty
Parameters: keywords (array), location_code, language_code
Output: Keyword, difficulty score (0-100), interpretation (Easy/Medium/Hard/Very Hard).
计算关键词难度评分，评估排名竞争力。
MCP工具： 
dataforseo_labs_bulk_keyword_difficulty
参数： keywords（数组）、location_code、language_code
输出： 关键词、难度评分（0-100）、难度等级（简单/中等/困难/极难）。

/seo dataforseo intent <keywords>

/seo dataforseo intent <keywords>

Classify keywords by user search intent.
MCP tools: 
dataforseo_labs_search_intent
Parameters: keywords (array), location_code, language_code
Output: Keyword, intent type (informational, navigational, commercial, transactional), confidence score.
对关键词进行用户搜索意图分类。
MCP工具： 
dataforseo_labs_search_intent
参数： keywords（数组）、location_code、language_code
输出： 关键词、意图类型（信息型、导航型、商业型、交易型）、置信度评分。

/seo dataforseo trends <keyword>

/seo dataforseo trends <keyword>

Analyze keyword trends over time using Google Trends data.
MCP tools: 
kw_data_google_trends_explore
Parameters: keywords (array), location_code, date_from, date_to, language_code
Output: Keyword, time series data, trend direction, seasonality signals.
使用Google Trends数据分析关键词随时间的趋势。
MCP工具： 
kw_data_google_trends_explore
参数： keywords（数组）、location_code、date_from、date_to、language_code
输出： 关键词、时间序列数据、趋势方向、季节性信号。

Domain & Competitor Analysis

域名与竞品分析

/seo dataforseo backlinks <domain>

/seo dataforseo backlinks <domain>

Comprehensive backlink profile analysis.
MCP tools: 
backlinks_summary
, 
backlinks_backlinks
, 
backlinks_anchors
, 
backlinks_referring_domains
, 
backlinks_bulk_spam_score
, 
backlinks_timeseries_summary
Default parameters: limit=100 per sub-call
Output: Total backlinks, referring domains, domain rank, spam score, top anchors, new/lost backlinks over time, dofollow ratio, top referring domains.
全面的反向链接档案分析。
MCP工具： 
backlinks_summary
, 
backlinks_backlinks
, 
backlinks_anchors
, 
backlinks_referring_domains
, 
backlinks_bulk_spam_score
, 
backlinks_timeseries_summary
默认参数： 每个子调用limit=100
输出： 总反向链接数、引用域名数、域名排名、垃圾评分、顶级锚文本、新增/丢失反向链接趋势、Dofollow比例、顶级引用域名。

/seo dataforseo competitors <domain>

/seo dataforseo competitors <domain>

Identify competing domains and estimate traffic.
MCP tools: 
dataforseo_labs_google_competitors_domain
, 
dataforseo_labs_google_domain_rank_overview
, 
dataforseo_labs_bulk_traffic_estimation
Output: Competitor domains, keyword overlap %, estimated traffic, domain rank, common keywords.
识别竞品域名并估算流量。
MCP工具： 
dataforseo_labs_google_competitors_domain
, 
dataforseo_labs_google_domain_rank_overview
, 
dataforseo_labs_bulk_traffic_estimation
输出： 竞品域名、关键词重叠率、估算流量、域名排名、共同关键词。

/seo dataforseo ranked <domain>

/seo dataforseo ranked <domain>

List keywords a domain ranks for with positions and page data.
MCP tools: 
dataforseo_labs_google_ranked_keywords
, 
dataforseo_labs_google_relevant_pages
Default parameters: limit=100, location_code=2840
Output: Keyword, position, URL, search volume, traffic share, SERP features.
列出域名排名的关键词及其位置和页面数据。
MCP工具： 
dataforseo_labs_google_ranked_keywords
, 
dataforseo_labs_google_relevant_pages
默认参数： limit=100, location_code=2840
输出： 关键词、排名位置、URL、搜索量、流量占比、SERP特性。

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

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

Find shared keywords and backlink sources across 2-20 domains.
MCP tools: 
dataforseo_labs_google_domain_intersection
, 
backlinks_domain_intersection
Parameters: domains (2-20 array)
Output: Shared keywords with positions per domain, shared backlink sources, unique keywords per domain.
查找2-20个域名之间的共享关键词和反向链接来源。
MCP工具： 
dataforseo_labs_google_domain_intersection
, 
backlinks_domain_intersection
参数： domains（2-20个域名的数组）
输出： 各域名共享关键词及排名位置、共享反向链接来源、各域名独有关键词。

/seo dataforseo traffic <domains>

/seo dataforseo traffic <domains>

Estimate organic search traffic for one or more domains.
MCP tools: 
dataforseo_labs_bulk_traffic_estimation
Parameters: domains (array)
Output: Domain, estimated organic traffic, estimated traffic cost, top keywords.
估算一个或多个域名的自然搜索流量。
MCP工具： 
dataforseo_labs_bulk_traffic_estimation
参数： domains（数组）
输出： 域名、估算自然流量、估算流量成本、顶级关键词。

/seo dataforseo subdomains <domain>

/seo dataforseo subdomains <domain>

Enumerate subdomains with their ranking data and traffic estimates.
MCP tools: 
dataforseo_labs_google_subdomains
Parameters: target (domain), location_code, language_code
Output: Subdomain, ranked keywords count, estimated traffic, organic cost.
枚举子域名及其排名数据和流量估算。
MCP工具： 
dataforseo_labs_google_subdomains
参数： target（域名）、location_code、language_code
输出： 子域名、排名关键词数量、估算流量、自然流量成本。

/seo dataforseo top-searches <domain>

/seo dataforseo top-searches <domain>

Find the most popular search queries that mention a specific domain in results.
MCP tools: 
dataforseo_labs_google_top_searches
Parameters: target (domain), location_code, language_code
Output: Query, search volume, domain position, SERP features, traffic share.
查找结果中提及该域名的最热门搜索查询。
MCP工具： 
dataforseo_labs_google_top_searches
参数： target（域名）、location_code、language_code
输出： 查询词、搜索量、域名排名位置、SERP特性、流量占比。

Technical / On-Page

技术/页面内分析

/seo dataforseo onpage <url>

/seo dataforseo onpage <url>

Run on-page analysis including Lighthouse audit and content parsing.
MCP tools: 
on_page_instant_pages
, 
on_page_content_parsing
, 
on_page_lighthouse
Usage:
  • on_page_instant_pages
    :Quick page analysis (status codes, meta tags, content size, page timing, broken links, on-page checks)
  • on_page_content_parsing
    :Extract and parse page content (plain text, word count, structure)
  • on_page_lighthouse
    :Full Lighthouse audit (performance score, accessibility, best practices, SEO, Core Web Vitals)
Output: Pages crawled, status codes, meta tags, titles, content size, load times, Lighthouse scores, broken links, resource analysis.
运行页面内分析，包括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>

/seo dataforseo tech <domain>

Detect technologies used on a domain.
MCP tools: 
domain_analytics_technologies_domain_technologies
Output: Technology name, version, category (CMS, analytics, CDN, framework, etc.).
检测域名使用的技术栈。
MCP工具： 
domain_analytics_technologies_domain_technologies
输出： 技术名称、版本、类别（CMS、分析工具、CDN、框架等）。

/seo dataforseo whois <domain>

/seo dataforseo whois <domain>

Retrieve WHOIS registration data.
MCP tools: 
domain_analytics_whois_overview
Output: Registrar, creation date, expiration date, nameservers, registrant info (if public).
获取WHOIS注册数据。
MCP工具： 
domain_analytics_whois_overview
输出： 注册商、创建日期、到期日期、域名服务器、注册人信息（若公开）。

Content & Business Data

内容与企业数据

/seo dataforseo content <keyword/url>

/seo dataforseo content <keyword/url>

Analyze content quality, search for content by topic, and track phrase trends.
MCP tools: 
content_analysis_search
, 
content_analysis_summary
, 
content_analysis_phrase_trends
Parameters: keyword (for search/trends) or URL (for summary)
Output: Content matches with quality scores, sentiment analysis, readability metrics, phrase trend data over time.
分析内容质量、按主题搜索内容并追踪短语趋势。
MCP工具： 
content_analysis_search
, 
content_analysis_summary
, 
content_analysis_phrase_trends
参数： keyword（用于搜索/趋势分析）或URL（用于内容摘要）
输出： 带质量评分的内容匹配结果、情感分析、可读性指标、短语随时间的趋势数据。

/seo dataforseo listings <keyword>

/seo dataforseo listings <keyword>

Search business listings for local SEO competitive analysis.
MCP tools: 
business_data_business_listings_search
Parameters: keyword, location (optional)
Output: Business name, description, category, address, phone, domain, rating, review count, claimed status.
搜索企业列表，用于本地SEO竞品分析。
MCP工具： 
business_data_business_listings_search
参数： keyword、location（可选）
输出： 企业名称、描述、类别、地址、电话、域名、评分、评论数、认领状态。

AI Visibility / GEO

AI可见性 / GEO分析

/seo dataforseo ai-scrape <query>

/seo dataforseo ai-scrape <query>

Scrape what ChatGPT web search returns for a query. Real GEO visibility check: see which sources ChatGPT cites for your target keywords.
MCP tools: 
ai_optimization_chat_gpt_scraper
Parameters: query, location_code (optional), language_code (optional). Use 
ai_optimization_chat_gpt_scraper_locations
to look up available locations.
Output: ChatGPT response content, cited sources/URLs, referenced domains.
抓取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>

/seo dataforseo ai-mentions <keyword>

Track how LLMs mention brands, domains, and topics. Critical for GEO. Measures actual AI visibility across multiple LLM platforms.
MCP tools: 
ai_opt_llm_ment_search
, 
ai_opt_llm_ment_top_domains
, 
ai_opt_llm_ment_top_pages
, 
ai_opt_llm_ment_agg_metrics
Parameters: keyword, location_code (optional), language_code (optional). Use 
ai_opt_llm_ment_loc_and_lang
for available locations/languages and 
ai_optimization_llm_models
for supported LLM models.
Workflow:
  1. Search LLM mentions with 
    ai_opt_llm_ment_search
    (find mentions of a brand/keyword across LLM responses)
  2. Get top cited domains with 
    ai_opt_llm_ment_top_domains
    (which domains are most cited for this topic)
  3. Get top cited pages with 
    ai_opt_llm_ment_top_pages
    (which specific pages are most cited)
  4. Get aggregate metrics with 
    ai_opt_llm_ment_agg_metrics
    (overall mention volume, trends)
Output: LLM mention count, top cited domains with frequency, top cited pages, mention trends over time, cross-platform visibility scores.
Advanced: Use 
ai_opt_llm_ment_cross_agg_metrics
for cross-model comparison (how mentions differ across ChatGPT, Claude, Perplexity, etc.).
追踪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模型。
工作流程：
  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等模型的提及差异）。

Available Utility Tools

可用工具工具

These DataForSEO tools are available for internal use by the agent but do not have dedicated commands:
  • serp_locations
    :Location code lookups for SERP queries
  • serp_youtube_locations
    :Location code lookups for YouTube queries
  • kw_data_google_ads_locations
    :Location lookups for keyword data
  • kw_data_dfs_trends_demography
    :Demographic data for trend analysis
  • kw_data_dfs_trends_subregion_interests
    :Subregion interest data for trends
  • kw_data_dfs_trends_explore
    :DFS proprietary trends data
  • kw_data_google_trends_categories
    :Google Trends category lookups
  • dataforseo_labs_google_keyword_overview
    :Quick keyword metrics overview
  • dataforseo_labs_google_historical_serp
    :Historical SERP results for a keyword
  • dataforseo_labs_google_serp_competitors
    :Competitors for a specific SERP
  • dataforseo_labs_google_keywords_for_site
    :Keywords a site ranks for (alternative to ranked)
  • dataforseo_labs_google_page_intersection
    :Page-level intersection analysis
  • dataforseo_labs_google_historical_rank_overview
    :Historical domain rank data
  • dataforseo_labs_google_historical_keyword_data
    :Historical keyword metrics
  • dataforseo_labs_available_filters
    :Available filter options for Labs endpoints
  • backlinks_competitors
    :Find domains with similar backlink profiles
  • backlinks_bulk_backlinks
    :Bulk backlink counts for multiple targets
  • backlinks_bulk_new_lost_referring_domains
    :Bulk new/lost referring domains
  • backlinks_bulk_new_lost_backlinks
    :Bulk new/lost backlinks
  • backlinks_bulk_ranks
    :Bulk rank overview for multiple targets
  • backlinks_bulk_referring_domains
    :Bulk referring domain counts
  • backlinks_domain_pages_summary
    :Summary of pages on a domain
  • backlinks_domain_pages
    :List pages on a domain with backlink data
  • backlinks_page_intersection
    :Shared backlink sources at page level
  • backlinks_referring_networks
    :Referring network analysis
  • backlinks_timeseries_new_lost_summary
    :Track new/lost backlinks over time
  • backlinks_bulk_pages_summary
    :Bulk page summaries
  • backlinks_available_filters
    :Available filter options for Backlinks endpoints
  • domain_analytics_whois_available_filters
    :WHOIS filter options
  • domain_analytics_technologies_available_filters
    :Technology detection filter options
  • ai_opt_kw_data_loc_and_lang
    :AI optimization keyword data locations/languages
  • ai_optimization_keyword_data_search_volume
    :AI-specific keyword volume data
  • ai_optimization_llm_response
    :Direct LLM response analysis
  • ai_optimization_llm_mentions_filters
    :Available filters for LLM mentions
  • ai_optimization_chat_gpt_scraper_locations
    :Available locations for ChatGPT scraper
以下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
    : 反向链接端点的可用筛选选项
  • 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抓取工具的可用地区

Cross-Skill Integration

跨功能集成

When DataForSEO MCP tools are available, other claude-seo skills can leverage live data:
  • seo-audit:Spawn 
    seo-dataforseo
    agent for real SERP, backlink, on-page, and listings data
  • seo-technical:Use 
    on_page_instant_pages
    / 
    on_page_lighthouse
    for real crawl data, 
    domain_analytics_technologies_domain_technologies
    for stack detection
  • seo-content:Use 
    kw_data_google_ads_search_volume
    , 
    dataforseo_labs_bulk_keyword_difficulty
    , 
    dataforseo_labs_search_intent
    for real keyword metrics, 
    content_analysis_summary
    for content quality
  • seo-page:Use 
    serp_organic_live_advanced
    for real SERP positions, 
    backlinks_summary
    for link data
  • seo-geo:Use 
    ai_optimization_chat_gpt_scraper
    for real ChatGPT visibility, 
    ai_opt_llm_ment_search
    for LLM mention tracking
  • seo-plan:Use 
    dataforseo_labs_google_competitors_domain
    , 
    dataforseo_labs_google_domain_intersection
    , 
    dataforseo_labs_bulk_traffic_estimation
    for real competitive intelligence
当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
    获取真实竞品情报

Error Handling

错误处理

  • MCP server not connected: Report that DataForSEO extension is not installed or MCP server is unreachable. Suggest running 
    ./extensions/dataforseo/install.sh
  • API authentication failed: Report invalid credentials. Suggest checking DataForSEO API login/password in MCP config
  • Rate limit exceeded: Report the limit hit and suggest waiting before retrying
  • No results returned: Report "no data found" for the query rather than guessing. Suggest broadening the query or checking location/language codes
  • Invalid location code: Report the error and suggest using the locations lookup tool to find the correct code
  • MCP服务器未连接: 告知用户DataForSEO扩展未安装或MCP服务器不可达。建议运行
    ./extensions/dataforseo/install.sh
  • API认证失败: 告知用户凭证无效。建议检查MCP配置中的DataForSEO API登录信息/密码
  • 超出速率限制: 告知用户已达限制，建议稍后重试
  • 无结果返回: 告知用户“未找到数据”，而非猜测。建议放宽查询条件或检查地区/语言代码
  • 无效地区代码: 告知用户错误，并建议使用地区查询工具查找正确代码

Output Formatting

输出格式

Match existing claude-seo output patterns:
  • Use tables for comparative data
  • Prioritize issues as Critical > High > Medium > Low
  • Include specific, actionable recommendations
  • Show scores as XX/100 where applicable
  • Note data source as "DataForSEO (live)" to distinguish from static analysis
匹配现有claude-seo输出模式：
  • 对比数据使用表格
  • 按优先级排序问题：严重 > 高 > 中 > 低
  • 包含具体、可执行的建议
  • 评分以XX/100格式展示
  • 标注数据来源为“DataForSEO（实时）”，以区分静态分析