DataForSEO MCP — MCP-сервер Claude Code: что делает и как установить
Интегрирует DataForSEO в агентные среды: добавляет поиск по документации API и выполняет запросы к сервису с нормализованной обработкой ошибок.
claude mcp add --env DATAFORSEO_USERNAME=<DATAFORSEO_USERNAME> --env DATAFORSEO_PASSWORD=<DATAFORSEO_PASSWORD> --env DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD> --transport stdio dataforseo-mcp -- npx -y @scalably-io/dataforseo-mcpЧто делает DataForSEO MCP
Сервер оборачивает официальный интерфейс DataForSEO и добавляет встроенный поиск по документации. В распоряжении агента четыре инструмента: бесплатные docs_list_sections, docs_index и docs_search помогают изучить доступные разделы и форматы эндпоинтов, а api_request отправляет боевой запрос к API.
Каждый вызов возвращает структурированный JSON со статусом, предупреждениями и кодами восстановления. Ошибки приводятся к единообразному виду, избавляя модель от разбора сырых пакетов вендора.
Для работы нужны учётные данные из личного кабинета: логин и пароль API передаются через переменные окружения DATAFORSEO_USERNAME и DATAFORSEO_PASSWORD. Вызовы через api_request расходуют реальный баланс аккаунта, а в случае неопределённого ответа сервер выдаёт ошибку ambiguous_paid_request, защищая от случайных повторных списаний.
Какие задачи решает
- находить нужные эндпоинты DataForSEO через локальный поиск по документации
- отправлять аутентифицированные запросы к API DataForSEO прямо из чата с агентом
- получать стандартизированные ответы об ошибках вместо сырых пакетов вендора
- предотвращать повторные списания баланса при сбоях платных запросов
Примеры запросов агенту
- Поищи в документации DataForSEO методы для выгрузки выдачи Google SERP
- Проверь структуру параметров для анализа обратных ссылок через
docs_search - Отправь запрос к API DataForSEO через
api_request, чтобы оценить позиции домена
Как установить DataForSEO MCP
Командой платформы
claude mcp add --env DATAFORSEO_USERNAME=<DATAFORSEO_USERNAME> --env DATAFORSEO_PASSWORD=<DATAFORSEO_PASSWORD> --env DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD> --transport stdio dataforseo-mcp -- npx -y @scalably-io/dataforseo-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add dataforseo-mcp --env DATAFORSEO_USERNAME=<DATAFORSEO_USERNAME> --env DATAFORSEO_PASSWORD=<DATAFORSEO_PASSWORD> --env DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD> -- npx -y @scalably-io/dataforseo-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"dataforseo-mcp": {
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"dataforseo-mcp": {
"type": "stdio",
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DATAFORSEO_USERNAME=<DATAFORSEO_USERNAME> -e DATAFORSEO_PASSWORD=<DATAFORSEO_PASSWORD> -e DATAFORSEO_PROXY_TEST_CHILD=<DATAFORSEO_PROXY_TEST_CHILD> dataforseo-mcp npx -y @scalably-io/dataforseo-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DataForSEO MCP
Как установить DataForSEO MCP в Claude Code?
Запустите команду `claude mcp add dataforseo-mcp -e DATAFORSEO_USERNAME=<DATAFORSEO_USERNAME> -e DATAFORSEO_PASSWORD=<DATAFORSEO_PASSWORD> -- npx -y @scalably-io/dataforseo-mcp`, подставив свой логин и пароль от API.
Что делает DataForSEO MCP?
Сервер предоставляет четыре инструмента: три служат для поиска и чтения документации API вендора, а четвёртый выполняет запросы к сервису и приводит ответы к понятному для ИИ формату.
Берётся ли плата за поиск по документации DataForSEO?
Нет, инструменты линейки docs_* полностью бесплатны. Деньги с баланса DataForSEO списываются только при фактических вызовах эндпоинтов через api_request.
