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_USERNAME）
- API密码（DATAFORSEO_PASSWORD）
- 支持Basic Authentication（HTTP服务器）
4.3 数据格式
服务返回JSON格式的响应数据，支持：
- 完整API响应（DATAFORSEO_FULL_RESPONSE=true）
- 过滤和转换的简洁格式（默认）
- 自定义字段选择
4.4 服务器配置
环境变量配置：
# 必需 export DATAFORSEO_USERNAME=your_username export DATAFORSEO_PASSWORD=your_password # 可选：指定启用的模块（逗号分隔） export ENABLED_MODULES="SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS" # 可选：启用完整API响应 export DATAFORSEO_FULL_RESPONSE="false" # 可选：启用简单过滤器架构 export DATAFORSEO_SIMPLE_FILTER="false"Claude Desktop配置：
{ "mcpServers": { "dataforseo": { "command": "npx", "args": ["dataforseo-mcp-server"], "env": { "DATAFORSEO_USERNAME": "your_username", "DATAFORSEO_PASSWORD": "your_password" } } } }5. 接口定义
可用模块
| 模块名称 | 功能描述 | 对应API |
|---|---|---|
| AI_OPTIMIZATION | 关键词发现、对话优化、LLM基准测试 | AI Optimization API |
| SERP | 实时搜索引擎结果页面数据 | SERP API |
| KEYWORDS_DATA | 关键词研究和点击流数据 | Keywords Data API |
| ONPAGE | 网站爬取和SEO性能指标 | OnPage API |
| DATAFORSEO_LABS | 专有数据库和算法分析 | DataForSEO Labs API |
| BACKLINKS | 反向链接分析 | Backlinks API |
| BUSINESS_DATA | 业务评论和信息 | Business Data API |
| DOMAIN_ANALYTICS | 网站技术和Whois数据 | Domain Analytics API |
| CONTENT_ANALYSIS | 品牌监控和情感分析 | Content Analysis API |
工具参数示例
每个工具支持以下通用参数：
- 必填参数：根据具体API要求
- fields：指定返回的字段（可选）
- language：语言代码（可选）
- location：位置信息（可选）
6. 快速开始
6.1 环境要求
- Node.js v14或更高版本
- DataForSEO API账户和凭证
- npm或npx
6.2 安装和运行
方式一：使用npx（推荐）
# 设置环境变量 export DATAFORSEO_USERNAME=your_username export DATAFORSEO_PASSWORD=your_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 Auth
- Cloudflare Worker：适合生产环境，全球边缘分发
错误处理：
- 检查API凭证是否正确
- 确认DataForSEO账户有足够的API配额
- 查看服务器日志获取详细错误信息
- 使用
DATAFORSEO_FULL_RESPONSE=true获取完整错误详情
