营销增长
需要实时 SEO/SERP、关键词、外链、AI…
已安装 DataForSEO MCP 扩展时,用实时搜索数据做 SERP、关键词、外链、页面、竞品、本地商家和 LLM 提及分析。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要实时 SEO/SERP、关键词、外链特定
解决思路
- 安装 DataForSEO 扩展:运行 `./extensions/dataforseo/install.sh`。
- 使用任何 DataForSEO 工具前,先检查 MCP server 是否连接:确认 `serp_organic_live_advanced` 或任意 DataForSEO 工具可用;若不可用,告知用户扩展未安装并提供安装说明。
- 按 API 信用额度控制调用:优先使用 bulk endpoints,而不是多次单条调用;除用户指定外,使用默认参数(US、English);在会话内缓存结果,不重复拉取同一数据;运行昂贵操作(完整外链爬取、大关键词列表)前先警告用户。
- 每次 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 自然搜索结果。
- 运行 `/seo dataforseo serp-images <keyword>`:获取 Google Images 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 + parsing)。
- 运行 `/seo dataforseo tech <domain>`:做技术栈检测。
- 运行 `/seo dataforseo whois <domain>`:查 WHOIS 注册数据。
- 运行 `/seo dataforseo content <keyword/url>`:做内容分析和趋势。
- 运行 `/seo dataforseo listings <keyword>`:搜商家列表。
- 运行 `/seo dataforseo ai-scrape <query>`:用 ChatGPT web scraper 做 GEO。
- 运行 `/seo dataforseo ai-mentions <keyword>`:跟踪 LLM 提及以做 GEO。
- 运行 `/seo dataforseo serp <keyword>`,MCP 工具 `serp_organic_live_advanced`,默认参数 `location_code=2840` (US)、`language_code=en`、`device=desktop`、`depth=100`;支持通过 `se` 参数切换 Google、Bing、Yahoo(指定 bing 或 yahoo);输出 rank、URL、title、description、domain、featured snippets、AI overview references、People Also Ask。
- 运行 `/seo dataforseo serp-youtube <keyword>`,MCP 工具 `serp_youtube_organic_live_advanced`;输出视频标题、频道、观看量、上传日期、描述、URL;用于 GEO,因 YouTube 提及与 AI 引用相关性最强。
- 运行 `/seo dataforseo youtube <video_id>`,MCP 工具 `serp_youtube_video_info_live_advanced`、`serp_youtube_video_comments_live_advanced`、`serp_youtube_video_subtitles_live_advanced`;参数 `video_id`(如 dQw4w9WgXcQ);输出视频元数据、热门评论及互动、字幕/转录文本;把 YouTube 提及当作 GEO 信号,但注意 AI 可见性相关性取决于方法论。
- 运行 `/seo dataforseo serp-images <keyword>`,MCP 工具 `serp_google_images_live_advanced`,默认参数 `location_code=2840` (US)、`language_code=en`、`device=desktop`、`depth=100`;参数 `keyword` 必填,`depth` 可选最大 700(按每 100 个结果增量计费),`search_param` 可选(如 site:example.com);警告:使用 `site:` 或 `filetype:` 操作符会产生 5 倍 API 成本,运行前警告用户;输出 position、title、alt text、source page URL、direct image URL、domain、encoded URL;分析并给出域名主导度(按数量取前 10 域名)、Alt text 模式、格式分布(从 image_url 扩展名推断 WebP/JPEG/PNG)、机会识别(用户有自然排名但无图片展示的关键词)。
- 运行 `/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`;输出 keyword、search volume、CPC、competition level、keyword difficulty、trend。
- 运行 `/seo dataforseo volume <keywords>`,MCP 工具 `kw_data_google_ads_search_volume`,参数 `keywords`(数组,逗号分隔)、`location_code`、`language_code`;输出 keyword、月搜索量、CPC、competition、月趋势数据。
- 运行 `/seo dataforseo difficulty <keywords>`,MCP 工具 `dataforseo_labs_bulk_keyword_difficulty`,参数 `keywords`(数组)、`location_code`、`language_code`;输出 keyword、难度分数(0-100)、解释(Easy/Medium/Hard/Very Hard)。
- 运行 `/seo dataforseo intent <keywords>`,MCP 工具 `dataforseo_labs_search_intent`,参数 `keywords`(数组)、`location_code`、`language_code`;输出 keyword、意图类型(informational、navigational、commercial、transactional)、confidence score。
- 运行 `/seo dataforseo trends <keyword>`,MCP 工具 `kw_data_google_trends_explore`,参数 `keywords`(数组)、`location_code`、`date_from`、`date_to`、`language_code`;输出 keyword、时间序列数据、趋势方向、季节性信号。
- 运行 `/seo dataforseo backlinks <domain>`,MCP 工具 `backlinks_summary`、`backlinks_backlinks`、`backlinks_anchors`、`backlinks_referring_domains`、`backlinks_bulk_spam_score`、`backlinks_timeseries_summary`,默认参数每个子调用 `limit=100`;输出总外链、引用域名、domain rank、spam score、top anchors、新增/丢失外链随时间变化、dofollow 比例、top referring domains。
- 运行 `/seo dataforseo competitors <domain>`,MCP 工具 `dataforseo_labs_google_competitors_domain`、`dataforseo_labs_google_domain_rank_overview`、`dataforseo_labs_bulk_traffic_estimation`;输出竞品域名、关键词重叠百分比、估算流量、domain rank、共同关键词。
- 运行 `/seo dataforseo ranked <domain>`,MCP 工具 `dataforseo_labs_google_ranked_keywords`、`dataforseo_labs_google_relevant_pages`,默认参数 `limit=100`、`location_code=2840`;输出 keyword、position、URL、search volume、traffic share、SERP features。
- 运行 `/seo dataforseo intersection <domain1> <domain2> [...]`,MCP 工具 `dataforseo_labs_google_domain_intersection`、`backlinks_domain_intersection`,参数 `domains`(2-20 个数组);输出每个域名在各关键词的位置、共同外链来源、每个域名的独有关键词。
- 运行 `/seo dataforseo traffic <domains>`,MCP 工具 `dataforseo_labs_bulk_traffic_estimation`,参数 `domains`(数组);输出 domain、估算自然流量、估算流量成本、top keywords。
- 运行 `/seo dataforseo subdomains <domain>`,MCP 工具 `dataforseo_labs_google_subdomains`,参数 `target`(domain)、`location_code`、`language_code`;输出 subdomain、排名关键词数量、估算流量、organic cost。
- 运行 `/seo dataforseo top-searches <domain>`,MCP 工具 `dataforseo_labs_google_top_searches`,参数 `target`(domain)、`location_code`、`language_code`;输出 query、search volume、domain position、SERP features、traffic share。
- 运行 `/seo dataforseo onpage <url>`,MCP 工具 `on_page_instant_pages`、`on_page_content_parsing`、`on_page_lighthouse`;用法:`on_page_instant_pages` 做快速页面分析(状态码、meta tags、内容大小、页面计时、坏链、on-page 检查);`on_page_content_parsing` 提取和解析页面内容(纯文本、词数、结构);`on_page_lighthouse` 做完整 Lighthouse 审计(性能分数、可访问性、最佳实践、SEO、Core Web Vitals);输出已爬取页面、状态码、meta tags、标题、内容大小、加载时间、Lighthouse 分数、坏链、资源分析。
- 运行 `/seo dataforseo tech <domain>`,MCP 工具 `domain_analytics_technologies_domain_technologies`;输出技术名称、版本、类别(CMS、analytics、CDN、framework 等)。
- 运行 `/seo dataforseo whois <domain>`,MCP 工具 `domain_analytics_whois_overview`;输出 registrar、creation date、expiration date、nameservers、registrant info(如公开)。
- 运行 `/seo dataforseo content <keyword/url>`,MCP 工具 `content_analysis_search`、`content_analysis_summary`、`content_analysis_phrase_trends`;参数:keyword(用于 search/trends)或 URL(用于 summary);输出内容匹配及质量分、情感分析、可读性指标、短语趋势数据。
- 运行 `/seo dataforseo listings <keyword>`,MCP 工具 `business_data_business_listings_search`;参数 keyword、location(可选);输出 business name、description、category、address、phone、domain、rating、review count、claimed status。
- 运行 `/seo dataforseo ai-scrape <query>`,MCP 工具 `ai_optimization_chat_gpt_scraper`;参数 query、location_code(可选)、language_code(可选);用 `ai_optimization_chat_gpt_scraper_locations` 查找可用位置;输出 ChatGPT 响应内容、引用来源/URL、引用的域名。
- 运行 `/seo dataforseo ai-mentions <keyword>`,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 响应中的提及;2) 用 `ai_opt_llm_ment_top_domains` 获取该主题被引用最多的域名;3) 用 `ai_opt_llm_ment_top_pages` 获取被引用最多的具体页面;4) 用 `ai_opt_llm_ment_agg_metrics` 获取总体提及量、趋势;输出 LLM 提及数、按频率的 top cited domains、top cited pages、提及趋势、跨平台可见性分数;高级:用 `ai_opt_llm_ment_cross_agg_metrics` 做跨模型比较(ChatGPT、Claude、Perplexity 等提及差异)。
- 当需要查找特定工具(位置查询、批量操作、历史数据、过滤选项)时,加载 `references/tool-catalog.md`。
- 当 DataForSEO MCP 工具可用时,其他 claude-seo 技能可利用实时数据:`seo-audit` 可调用 `seo-dataforseo` agent 获取真实 SERP、backlink、on-page、listings 数据。
- `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 数据,并与 on-page 图片审计交叉引用。
- `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 server 未连接:报告 DataForSEO 扩展未安装或 MCP server 不可达;建议运行 `./extensions/dataforseo/install.sh`。
- API 认证失败:报告凭据无效;建议检查 MCP 配置中的 DataForSEO API login/password。
- 超过速率限制:报告触及限制,建议等待后重试。
- 无结果:报告该查询 no data found,不要猜测;建议扩大查询范围或检查 location/language codes。
- 无效 location code:报告错误,建议使用 locations lookup tool 查找正确代码。
- 输出格式化:比较数据用表格;问题按 Critical > High > Medium > Low 优先级;包含具体可执行建议;适用时分数显示为 XX/100;注明数据来源为 DataForSEO (live) 以区别于静态分析。
适用边界 · 注意事项
- 未安装 DataForSEO MCP server 或未配置 DataForSEO API 凭据时。
- 需要完全免费/离线或不想按 API 调用付费的 SEO 分析时。
- 不想配置成本护栏,且可能触发高成本操作(如完整外链爬取、大关键词列表、使用 site: 或 filetype: 的图片查询)时。