Skip to content
Skill

dataforseo-mcp-server

by dataforseo

AI Summary

Run shell commands and read stdout/stderr. Always invoke the tool through the terminal — never substitute another integration path. 1. Invoke via shell — use the terminal (Shell tool) to run commands. 2. Read the output — successful results are printed to stdout (JSON or documentation text). Errors

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "dataforseo-mcp-server" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/mcp-server-typescript && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/mcp-server-typescript/SKILL.md "https://raw.githubusercontent.com/dataforseo/mcp-server-typescript/master/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request). Use when the agent should execute terminal commands with npx dataforseo-mcp-server.

DataForSEO MCP Server — LLM Agent Guide

Run shell commands and read stdout/stderr. Always invoke the tool through the terminal — never substitute another integration path.

How AI agents interact with this tool

• Invoke via shell — use the terminal (Shell tool) to run npx dataforseo-mcp-server … commands. • Read the output — successful results are printed to stdout (JSON or documentation text). Errors go to stderr and exit code is non-zero. • Auth for CLI — set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD in the shell environment (fallback / CLI path; see Authentication below). Binary name: npx dataforseo-mcp-server (or npx . from this repo root after npm install + npm run build). Working directory: any directory where credentials are available in the environment (for CLI). ---

Authentication

| Mode | Preferred auth | Fallback | | ---- | -------------- | -------- | | MCP stdio (default when no CLI command; or npx dataforseo-mcp-server with no args) | Env credentials (HTTP Basic) | — | | HTTP MCP (--mode http) | OAuth 2.0 Bearer via authorization server https://data.dataforseo.com (discovery at /.well-known/oauth-protected-resource) | DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD in env | | CLI (docs / request / --cli) | Env credentials (HTTP Basic) | — | Override the authorization server with AUTH_SERVER_URL if needed. ---

Quick reference

| Task | Shell command | | ---------------------------------- | --------------------------------------------------------------------------- | | Docs index | npx dataforseo-mcp-server docs index [--section "SERP API"] | | List sections | npx dataforseo-mcp-server docs index --list-sections | | Endpoint docs | npx dataforseo-mcp-server docs search <url-or-path> | | Endpoint docs (with code examples) | npx dataforseo-mcp-server docs search <url-or-path> --need-code-example | | GET request | npx dataforseo-mcp-server request -X GET -p /v3/... | | POST request | npx dataforseo-mcp-server request -X POST -p <path> --param key=value ... | | POST request (JSON) | npx dataforseo-mcp-server request -X POST -p <path> -d '<json-array>' | By default, API paths use the .ai suffix (e.g. /v3/serp/google/organic/live/regular.ai). Pass --no-ai-mode to use the standard path. CLI credentials (fallback / shell): set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD as environment variables. Get keys at https://app.dataforseo.com/api-access `bash export DATAFORSEO_LOGIN=your_api_login export DATAFORSEO_PASSWORD=your_api_password ` Windows PowerShell: $env:DATAFORSEO_LOGIN="..." / $env:DATAFORSEO_PASSWORD="...". CMD: set DATAFORSEO_LOGIN=... DATAFORSEO_USERNAME is also accepted as an alias for DATAFORSEO_LOGIN. For HTTP MCP, prefer OAuth; env credentials are only a fallback when no Authorization header is present. ---

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 19d ago
● Active
Adoption100+ stars on GitHub
261 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars261
Forks118
Issues5
Updated19d ago
View on GitHub
Apache-2.0 License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code