DataForSEO MCP Server

社区

通过 MCP 访问 DataForSEO SEO 数据。

分类: 其他第 158 / 230
Stars: ★ 254 非常热门
传输方式: Streamable HTTP · SSE
运行环境: Node.js 14+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 19 天前

49FMRS · D

仓库提供了面向 DataForSEO 多个 API 的 MCP 服务器实现，支持本地、HTTP 和 Cloudflare Worker 运行方式。README 明确说明了凭据、模块配置、响应过滤和部署方法，但未提供缓存的服务器清单或具体工具标识符。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

9/20

文档质量

11/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: README 描述了本地、HTTP 和 Cloudflare Worker 启动方式、环境变量及错误格式化意图，但服务器清单未缓存，未提供源文件、CI 或已提交测试来验证 MCP 初始化、工具列表握手和实际工具行为。文档中的示例还出现重复声明 `const result` 以及 `src/code` 与 `src/core` 路径不一致，降低了可复现性，因此明显扣分。
安全与权限 10/20: 凭据通过环境变量、Cloudflare secret 或 HTTP Basic Auth 传入，未见安装示例包含真实秘密；能力主要是向 DataForSEO 发起数据查询，未描述删除、付款或远程命令等危险默认操作。由于没有源代码证据，无法确认凭据是否被安全传递、HTTP 认证边界、模块最小权限、网络范围、日志脱敏或请求确认机制，因此仅给中等分数。
维护活跃度 9/20: 仓库标记为未归档，声明 Apache-2.0 许可证，并有 233 个 stars 和 4 个开放 issue，说明项目具备一定公开维护信号。可是提示中没有 releases、提交历史、依赖更新、维护者响应、漏洞披露渠道或安全响应流程；stars 也不计入质量分，因此扣除较多。
文档质量 11/20: README 覆盖运行时要求、凭据配置、模块开关、响应过滤、字段配置、HTTP/Worker 部署和 Claude 客户端示例，基本安装路径较完整。缺少可审查的工具清单与参数说明、API 成本/速率限制、数据边界、常见故障排查、版本兼容性和安全运维说明；同时存在模块默认值、目录路径及 Merchant 拼写等不一致，因此不能接近满分。
安装易用性 12/20: 提供 Node.js 14+、npm/npx、本地与 HTTP 启动命令、环境变量示例、Cloudflare 部署步骤和 Claude 的 HTTP 配置示例，主流场景的路径较清楚。仍需用户自行取得 DataForSEO 账号凭据并手动设置环境变量，未提供已缓存 manifest、可直接导入的完整客户端配置、平台差异说明或测试验证；因此属于可行但偏手工的安装体验。

静态评测 · 未实际运行收录于 2026-07-30

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要通过 AI 助手使用 DataForSEO API 的 SEO 团队
需要配置 API 模块、提示词或响应字段的开发者
需要本地、HTTP 或 Cloudflare Worker 部署方式的用户

不适合谁

不需要 DataForSEO API 的通用 MCP 用户
没有 DataForSEO API 凭据的用户
需要浏览器自动化、文件存储或数据库功能的用户

所需权限

需要 DataForSEO API 用户名和密码
可访问所启用 DataForSEO 模块对应的 API 数据
HTTP 模式支持 Basic Authentication，也可使用环境变量凭据

风险与副作用

API 凭据需要通过环境变量或 Cloudflare 密钥配置并妥善保护
启用多个模块或完整响应可能增加响应规模和 API 使用量
SSE 传输在 README 中标记为已弃用
API 返回的数据和费用受 DataForSEO 账户及其服务限制影响

安装接入

准备工作

运行环境：Node.js 14+

DATAFORSEO_USERNAME 必填 DataForSEO 账号登录名，在 dataforseo.com 注册后于账户设置中获取。

DATAFORSEO_PASSWORD 必填密钥 DataForSEO API 密码，与登录名配合使用，在 DataForSEO 账户设置中查看。

其他可选配置项（4 个）

ENABLED_MODULES 可选可选，逗号分隔的模块列表（如 SERP,ONPAGE），不设置则启用全部模块。

ENABLED_PROMPTS 可选可选，逗号分隔的提示名称列表，仅启用已启用模块中的这些提示。

DATAFORSEO_FULL_RESPONSE 可选可选，设为 true 时返回完整未修改的 API 响应，默认过滤精简。

DATAFORSEO_SIMPLE_FILTER 可选可选，设为 true 时使用简化的 filters schema，适用于 ChatGPT 等不支持嵌套结构的 LLM。

需要 Node.js 14 或更高版本以及 DataForSEO API 用户名和密码。克隆仓库后运行 npm install，设置 DATAFORSEO_USERNAME 和 DATAFORSEO_PASSWORD，然后运行 npm run build 和相应的启动命令。也可全局安装 dataforseo-mcp-server，或使用 npx 直接运行。HTTP 模式默认使用 3000 端口；Cloudflare Worker 部署需要 Wrangler。

MCP 配置 · JSON

{"name":"DataForSEO","description":"Access DataForSEO APIs via Cloudflare Worker","transport":{"type":"http","baseUrl":"https://your-worker.your-subdomain.workers.dev/mcp"}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "name": "DataForSEO",
  "description": "Access DataForSEO APIs via Cloudflare Worker",
  "transport": {
    "type": "http",
    "baseUrl": "https://your-worker.your-subdomain.workers.dev/mcp"
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

启动服务器并连接客户端后，在工具列表中应能看到 SERP、KEYWORDS_DATA 等已启用模块下的工具；输入一个关键词查询，若返回 DataForSEO 的搜索量或 SERP 数据即证明连接成功。

常见排障

确认 Node.js 版本至少为 14
确认 DATAFORSEO_USERNAME 和 DATAFORSEO_PASSWORD 已设置且有效
检查 ENABLED_MODULES、ENABLED_PROMPTS、DATAFORSEO_FULL_RESPONSE 和 DATAFORSEO_SIMPLE_FILTER 的拼写和值
HTTP 模式检查 3000 端口及 Basic Authentication 凭据
Cloudflare Worker 部署检查 Wrangler 登录状态、密钥和 Worker 路径
如字段缺失，检查字段配置文件或暂时禁用字段过滤

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查询关键词 digital marketing 在美国的搜索量和点击成本
获取 Google 上 SEO 工具这个关键词的实时 SERP 前十结果
分析 example.com 的外链情况，包括引用域名和锚文本分布
抓取 example.com 并给出页面级 SEO 性能指标

使用场景

关键词研究和搜索量分析

Google、Bing 和 Yahoo 的实时 SERP 数据获取

网站爬取和页面 SEO 指标分析

反向链接、域名和竞争对手分析

品牌监测、情感分析和引用管理

支持客户端

Claude

依据项目文档列出，未经本站实测。

详细介绍

DataForSEO MCP Server 是一个 TypeScript 实现的 Model Context Protocol 服务器，可让 AI 助手通过标准化接口访问选定的 DataForSEO API，获取 SEO、SERP、关键词、页面、反向链接、商业数据、域名分析、内容分析和商品数据。服务器可本地运行，也支持 HTTP 和 Cloudflare Worker 部署。