English Français العربية

DataForSEO MCP

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @scalably-io/dataforseo-mcp
Claude Code 
claude mcp add dataforseo-mcp -e 'DATAFORSEO_USERNAME=<your dataforseo_username>' -e 'DATAFORSEO_PASSWORD=<your dataforseo_password>' -e 'DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD>' -- npx -y @scalably-io/dataforseo-mcp@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dataforseo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@scalably-io/dataforseo-mcp@1.0.1"
            ],
            "env": {
                "DATAFORSEO_USERNAME": "<your dataforseo_username>",
                "DATAFORSEO_PASSWORD": "<your dataforseo_password>",
                "DATAFORSEO_PROXY_TEST_CHILD": "<DATAFORSEO_PROXY_TEST_CHILD>"
            }
        }
    }
}

Variables d'environnement

  • DATAFORSEO_USERNAME obligatoire secret DataForSEO account login (email) from the dashboard
  • DATAFORSEO_PASSWORD obligatoire secret DataForSEO account API password from the dashboard
  • DATAFORSEO_PROXY_TEST_CHILD Test suite only, with NODE_ENV=test: path of a fake child to spawn instead of the upstream server. Never set it in normal use

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. DataForSEO MCP
  2. Install
  3. Setup
  4. Tools (4)
  5. Configuration
  6. Reply shape
  7. Limits
  8. Verify
  9. Privacy Policy
  10. License

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:

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: 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: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

Questions fréquentes

Qu'est-ce que DataForSEO MCP ?

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

Comment installer DataForSEO MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add dataforseo-mcp -e 'DATAFORSEO_USERNAME=<your dataforseo_username>' -e 'DATAFORSEO_PASSWORD=<your dataforseo_password>' -e 'DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD>' -- npx -y @scalably-io/dataforseo-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour DataForSEO MCP ?

Oui. Il attend DATAFORSEO_USERNAME, DATAFORSEO_PASSWORD, à renseigner dans sa configuration.

DataForSEO MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient DataForSEO MCP ?

Il est publié par scalably-io. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.