DataForSEO MCP

Name: DataForSEO MCP
Author: scalably.io

本地服务

scalably.io商业与营销07 周前更新

代码仓库访问官网

关于 DataForSEO MCP

DataForSEO MCP 为需要查询 API 文档并发送 API 请求的用户封装了 DataForSEO 官方 MCP 服务。它增加了可搜索的文档索引，并统一响应与错误格式。

主要功能

01浏览 API 文档索引
02列出文档章节
03按 URL 搜索文档
04发送经过身份验证的 DataForSEO API 请求
05统一任务状态和错误响应

适用场景

01调用前查找相关 API 类别
02在文档中核实端点详情和价格
03以统一格式查看部分、待处理或失败的 API 结果

MCP 相关

向 MCP 客户端提供文档查询和经过身份验证的 API 请求工具，并将 API 调用转发给 DataForSEO 官方服务。需要 DataForSEO 账户凭据；API 请求可能产生费用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "io-scalably-dataforseo": {
      "command": "npx",
      "args": [
        "-y",
        "@scalably-io/dataforseo-mcp"
      ],
      "env": {
        "DATAFORSEO_USERNAME": "<DATAFORSEO_USERNAME>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "DATAFORSEO_PROXY_TEST_CHILD": "<DATAFORSEO_PROXY_TEST_CHILD>"
      }
    }
  }
}

启动命令npx -y @scalably-io/dataforseo-mcp

需要配置的环境变量

DATAFORSEO_USERNAME密钥DataForSEO account login (email) from the dashboard

DATAFORSEO_PASSWORD密钥DataForSEO account API password from the dashboard

DATAFORSEO_PROXY_TEST_CHILDTest suite only, with NODE_ENV=test: path of a fake child to spawn instead of the upstream server. Never set it in normal use

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@scalably-io/dataforseo-mcp1.0.1stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
section	string	否	按 API 章节筛选（例如 “SERP API”）

详细介绍

DataForSEO MCP

这是对 DataForSEO 官方 MCP 服务的轻量封装，增加了可搜索的文档索引和标准化错误。如果你只需要原始 API，请直接安装 dataforseo-mcp-server。

安装

Claude Code：

claude mcp add dataforseo -e DATAFORSEO_USERNAME=your-login -e DATAFORSEO_PASSWORD=your-password -- npx -y @scalably-io/dataforseo-mcp

Codex：

codex mcp add dataforseo --env DATAFORSEO_USERNAME=your-login --env DATAFORSEO_PASSWORD=your-password -- npx -y @scalably-io/dataforseo-mcp

Claude Desktop：此封装仅通过 npm 发布（其上游依赖会使桌面应用包超过 100 MB）。请改为从 https://github.com/dataforseo/mcp-server-typescript 安装 DataForSEO 自己的服务；你只会失去文档搜索工具。

设置

在 dataforseo.com 创建或打开 DataForSEO 账户。
从控制面板中获取 API 登录名（电子邮件地址）和 API 密码。
api_request 会调用实时 DataForSEO API，并可能按 DataForSEO 自身的定价产生费用；三个 docs_* 工具用于免费查询文档。

工具（4 个）

工具	功能
`docs_index`	获取 DataForSEO API 文档索引（llms.txt），可按版块筛选
`docs_list_sections`	返回可用的 DataForSEO API 文档版块名称
`docs_search`	从文档 URL 获取 DataForSEO API 文档
`api_request`	向 DataForSEO API 发起经过身份验证的请求（方法、路径或 url、请求正文，以及用于获取完整非 AI 优化响应的可选 noAiMode 标志）

使用 docs_list_sections 或 docs_index 选择 API 类别，然后使用 docs_search 查找准确的当前端点路径、方法、请求正文和定价，再调用 api_request。

配置

变量	必填	用途
`DATAFORSEO_USERNAME`	是	控制面板中的 DataForSEO 账户登录名（电子邮件）
`DATAFORSEO_PASSWORD`	是	控制面板中的 DataForSEO 账户 API 密码
`NODE_ENV`、`DATAFORSEO_PROXY_TEST_CHILD`	否	仅用于测试套件：当 `NODE_ENV=test` 时，封装会启动由 `DATAFORSEO_PROXY_TEST_CHILD` 指定的模拟子进程，而不是上游服务。正常使用时切勿设置这些变量

回复格式

每个工具都返回纯 JSON，包含 status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recovery。失败时会返回工具错误，文本格式为 <code>: <message> <hint>。api_request 会将 DataForSEO 的逐任务状态代码（待处理任务、无结果任务、部分失败和供应商错误代码）标准化为上述格式，而不是未经检查就返回 DataForSEO 的原始任务封装。

限制

api_request 会真实调用 DataForSEO API，并产生费用；DataForSEO 自身的账户余额和速率限制均适用。如果无法确认调用结果，付费端点的调用失败会报告为 ambiguous_paid_request 错误，因为盲目重试可能导致重复扣费。

验证

每个版本都会在 CHANGELOG.md 中列出软件包版本及其来源的生产提交；npm 发布时会附带来自 GitHub Actions 的溯源信息。每次推送时，CI 都会运行测试，并对打包后的 tarball 执行全新安装。

隐私政策

此服务在你自己的计算机上本地运行，并使用你自己的凭据。它不会收集个人数据，不包含遥测功能，不会持久化存储任何内容，并且只会与其封装的供应商 API 通信。包括 Scalably 在内的任何第三方都不会收到你的数据。联系方式：[email protected]。规范版本：https://scalably.io/connector-privacy.html