DataForSEO MCP

io.scalably由 scalably.io 發布v1.0.1更新於 Nov 3, 2026

DataForSEO MCP wrapper: searchable API docs plus normalized calls to the official server. 4 tools.

已驗證STDIO僅桌面網頁搜尋與抓取開發者工具

概覽

AI 產生的概覽

DataForSEO 官方 MCP 伺服器的封裝，加上可搜尋的文件索引與正規化回覆，並可呼叫真實的 DataForSEO API。

可以做什麼
  • 列出並取得 DataForSEO API 文件章節與文件索引
  • 檢索 API 文件中的端點路徑、方法、請求內容與價格
  • 以方法、路徑或 URL 及請求內容，向即時 DataForSEO API 送出帶驗證的請求
  • 回傳含 status、summary、warnings、recovery 的正規化 JSON，並統一處理廠商任務錯誤
適用情境
適合需要先查閱 DataForSEO 的 SEO、SERP 或關鍵字資料端點、再實際呼叫，並希望有文件檢索與更清楚錯誤處理的情況。若只需原始 API 存取，官方伺服器已足夠。
執行需求
透過 npx 以 Node.js 本機程序執行（npm 套件），僅限桌面端。需要 DataForSEO 帳戶，並設定環境變數 DATAFORSEO_USERNAME（帳戶電子郵件）與 DATAFORSEO_PASSWORD（API 密碼）。需要連線至 DataForSEO API 的網路。
安裝前請注意
api_request 會在你的帳戶餘額與速率限制下發出真實計費呼叫；付費端點呼叫失敗且結果無法確認時，可能回報 ambiguous_paid_request，因為盲目重試可能重複扣款。文件類工具免費。憑證以環境變數傳入。測試套件以外請勿設定 NODE_ENV 或 DATAFORSEO_PROXY_TEST_CHILD。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 DataForSEO MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

DataForSEO MCP

A thin wrapper around DataForSEO's official MCP server that adds a searchable docs index and normalized errors. If you only need the raw API, install dataforseo-mcp-server directly.

Install

Claude Code:

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

Codex:

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

Claude Desktop: this wrapper ships on npm only (its upstream dependency makes a desktop bundle over 100 MB). Install DataForSEO's own server from https://github.com/dataforseo/mcp-server-typescript instead; the docs-search tools are the only thing you lose.

Setup

  1. Create or open a DataForSEO account at dataforseo.com.
  2. Read the API login (an email address) and API password from the dashboard.
  3. api_request calls the live DataForSEO API and can incur cost per DataForSEO's own pricing; the three docs_* tools are free documentation lookups.

Tools (4)

ToolWhat it does
docs_indexFetch the DataForSEO API documentation index (llms.txt), optionally filtered by section
docs_list_sectionsReturn available DataForSEO API documentation section names
docs_searchFetch DataForSEO API documentation from a documentation URL
api_requestMake an authenticated request to the DataForSEO API (method, path or url, body, and an optional noAiMode flag for the full, non AI-optimized response)

Use docs_list_sections or docs_index to pick an API family, then docs_search for the exact current endpoint path, method, request body and pricing before calling api_request.

Configuration

VariableRequiredPurpose
DATAFORSEO_USERNAMEyesDataForSEO account login (email) from the dashboard
DATAFORSEO_PASSWORDyesDataForSEO account API password from the dashboard
NODE_ENV, DATAFORSEO_PROXY_TEST_CHILDnoTest suite only: with NODE_ENV=test the wrapper spawns the fake child named by DATAFORSEO_PROXY_TEST_CHILD instead of the upstream server. Never set them in normal use

Reply shape

Every tool returns plain JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures surface as a tool error whose text is <code>: <message> <hint>. api_request normalizes DataForSEO's per-task status codes (pending tasks, no-result tasks, partial failures, and vendor error codes) into that shape instead of returning DataForSEO's raw task envelope unexamined.

Limits

api_request is a real, billable call to the DataForSEO API; DataForSEO's own account balance and rate limits apply. A failed call to a paid endpoint is reported with an ambiguous_paid_request error when the outcome could not be confirmed, since retrying blind could double the charge.

Verify

Each release lists the package version and the production commit it was derived from in CHANGELOG.md; npm publishes with provenance from GitHub Actions. CI runs the tests and a clean install of the packed tarball on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: [email protected]. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

來源：README.md，提交 f25681d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分