用途：这是一个通过 DataForSEO MCP 服务器获取实时搜索数据的 SEO 技能扩展，提供实时 SERP 结果、关键词指标、外链档案、页面分析、内容分析、商业名录、AI 可见性检查与 LLM 提及追踪，覆盖 9 个 API 模块、79+ 个 MCP 工具。
安装前提：需先安装 DataForSEO 扩展，运行 ./extensions/dataforseo/install.sh。使用任何工具前应确认 serp_organic_live_advanced 等工具可用，不可用则提示用户扩展未安装并给出安装说明。
主要能力与用法：命令以 /seo dataforseo 开头。SERP 分析：serp（Google 自然结果，可通过 se 参数切换 Bing、Yahoo）、serp-youtube、youtube（视频深度分析，含评论与字幕）；serp-images 仅报告自然结果中的图片元素，因所固定的 MCP 服务器无 Google Images 工具，不是完整图片 SERP。关键词研究：keywords、volume、difficulty、intent、trends。域名与竞品分析：backlinks、competitors、ranked、intersection（2–20 个域名）、traffic、subdomains、top-searches。技术与页面：onpage（含 Lighthouse 审计与内容解析）、tech、whois。内容与商业数据：content、listings。GEO：ai-scrape（抓取 ChatGPT 网页搜索返回及引用来源）、ai-mentions（跨 LLM 平台追踪品牌/域名/主题提及）。
成本控制：DataForSEO 按 API 调用计费。调用前需运行成本估算命令 ${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo run dataforseo_costs.py check <endpoint> [--count N]，仅当返回 approved 才可继续；needs_approval 需向用户确认；blocked 则不得执行。调用后记录成本：${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo run dataforseo_costs.py log <endpoint> <actual_cost>。成本管理命令：/seo dataforseo costs today、costs summary、costs config --mode threshold --threshold 0.50。
限制：默认参数为美国（location_code=2840）、英语、桌面端。使用 site: 或 filetype: 等过滤操作符会产生 5 倍 API 成本，需提前警告用户。应优先使用批量端点、避免重复获取同一数据，运行昂贵操作（完整外链爬取、大型关键词列表）前需警告用户。具体定价表、预算预设与降本技巧需加载 references/cost-tiers.md，本资料暂未提供其内容。
错误处理：MCP 未连接时报告扩展未安装或服务器不可达；认证失败报告凭据无效；限流报告并建议等待；无结果应说明“no data found”而非猜测；无效位置代码建议使用位置查询工具。输出使用表格呈现对比数据，按 Critical > High > Medium > Low 排序问题，分数以 XX/100 表示，并标注数据来源为 DataForSEO（live）。