1. 服务概述一句话简介一个提供标准化接口访问多个SEO相关API的MCP服务器用于全面的数据检索和分析支持SERP、关键词研究、反向链接分析等功能。服务名称DataForSEO MCP Server版本号最新版本开发者/提供方DataForSEO官方协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下主要API模块 SERP API检索Google、Bing和Yahoo的实时搜索结果支持位置数据查询获取标题、描述和URL等信息 KEYWORDS_DATA API关键词研究和点击流数据搜索量、CPC等指标关键词发现和优化建议 BACKLINKS API全面的反向链接分析引用域和锚文本分布链接质量指标跟踪 ONPAGE API网站爬取和SEO性能指标可自定义爬取参数页面级SEO分析 DATAFORSEO_LABS API专有关键词、SERP和域数据库基于专有算法的数据分析深度SEO洞察 BUSINESS_DATA API从Google、Trustpilot、Tripadvisor收集业务评论业务实体公开数据评论情感分析 DOMAIN_ANALYTICS API网站流量和技术识别Whois详细信息域名分析数据 AI_OPTIMIZATION API关键词发现和对话优化实时LLM基准测试AI搜索优化数据 CONTENT_ANALYSIS API品牌监控和情感分析引用管理内容表现分析3. 使用场景该服务适合在以下情况下使用SEO分析和优化全面分析网站SEO表现识别优化机会关键词研究发现高价值关键词优化内容策略竞争对手分析分析竞争对手的SEO策略和表现反向链接监控跟踪和分析网站的反向链接配置品牌监控监控品牌提及和情感分析本地SEO分析本地搜索结果和业务评论技术SEO审计识别网站技术栈和性能问题4. 接入方式4.1 服务端点该服务支持多种部署方式本地服务器直接MCP通信HTTP服务器http://localhost:3000默认端口Cloudflare Worker无服务器边缘部署4.2 认证与权限需要DataForSEO API凭证API用户名DATAFORSEO_USERNAMEAPI密码DATAFORSEO_PASSWORD支持Basic AuthenticationHTTP服务器4.3 数据格式服务返回JSON格式的响应数据支持完整API响应DATAFORSEO_FULL_RESPONSEtrue过滤和转换的简洁格式默认自定义字段选择4.4 服务器配置环境变量配置# 必需 export DATAFORSEO_USERNAMEyour_username export DATAFORSEO_PASSWORDyour_password # 可选指定启用的模块逗号分隔 export ENABLED_MODULESSERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS # 可选启用完整API响应 export DATAFORSEO_FULL_RESPONSEfalse # 可选启用简单过滤器架构 export DATAFORSEO_SIMPLE_FILTERfalseClaude Desktop配置{ mcpServers: { dataforseo: { command: npx, args: [dataforseo-mcp-server], env: { DATAFORSEO_USERNAME: your_username, DATAFORSEO_PASSWORD: your_password } } } }5. 接口定义可用模块模块名称功能描述对应APIAI_OPTIMIZATION关键词发现、对话优化、LLM基准测试AI Optimization APISERP实时搜索引擎结果页面数据SERP APIKEYWORDS_DATA关键词研究和点击流数据Keywords Data APIONPAGE网站爬取和SEO性能指标OnPage APIDATAFORSEO_LABS专有数据库和算法分析DataForSEO Labs APIBACKLINKS反向链接分析Backlinks APIBUSINESS_DATA业务评论和信息Business Data APIDOMAIN_ANALYTICS网站技术和Whois数据Domain Analytics APICONTENT_ANALYSIS品牌监控和情感分析Content Analysis API工具参数示例每个工具支持以下通用参数必填参数根据具体API要求fields指定返回的字段可选language语言代码可选location位置信息可选6. 快速开始6.1 环境要求Node.js v14或更高版本DataForSEO API账户和凭证npm或npx6.2 安装和运行方式一使用npx推荐# 设置环境变量 export DATAFORSEO_USERNAMEyour_username export DATAFORSEO_PASSWORDyour_password # 直接运行无需安装 npx dataforseo-mcp-server方式二全局安装# 全局安装 npm install -g dataforseo-mcp-server # 运行 dataforseo-mcp-server方式三从源码构建# 克隆仓库 git clone https://github.com/dataforseo/mcp-server-typescript cd mcp-server-typescript # 安装依赖 npm install # 构建 npm run build # 运行本地服务器 npx dataforseo-mcp-server # 或运行HTTP服务器 npx dataforseo-mcp-server http6.3 使用示例// 在Claude中使用示例 // 用户: 查询best running shoes在Google上的前3个自然搜索结果 // Claude将使用SERP API工具获取数据 // 返回包含标题、描述、URL等信息的结果7. 注意事项API凭证管理妥善保管DataForSEO API凭证不要提交到版本控制系统使用环境变量存储敏感信息Cloudflare Worker部署时使用secrets管理凭证性能优化使用ENABLED_MODULES只启用需要的模块减少资源消耗使用字段配置文件指定返回字段减少响应大小默认使用过滤响应格式提高AI处理效率模块选择根据实际需求启用相应模块某些模块可能需要额外的API配额查看DataForSEO文档了解各API的详细功能部署选项本地部署适合开发和测试直接MCP通信HTTP服务器适合团队共享支持Basic AuthCloudflare Worker适合生产环境全球边缘分发错误处理检查API凭证是否正确确认DataForSEO账户有足够的API配额查看服务器日志获取详细错误信息使用DATAFORSEO_FULL_RESPONSEtrue获取完整错误详情