DataForSEO Connector: Standard I/O Model Context Protocol Server

This utility functions as a stdin/stdout bridge for interacting with the DataForSEO API suite, conforming to the Model Context Protocol (MCP) specification.

DataForSEO Access Registration

Secure your credentials via this affiliate link:

https://dataforseo.com/?aff=200885

Deployment Instructions

Execution can be performed directly using npx, requiring no prior global installation:

npx @skobyn/mcp-dataforseo --config '{"username":"YOUR_CRED","password":"YOUR_SECRET"}'

Alternatively, after global installation:

npm install -g @skobyn/mcp-dataforseo
mcp-dataforseo --config '{"username":"YOUR_CRED","password":"YOUR_SECRET"}'

Operation Protocol

Input structured JSON commands via standard input (stdin) and capture the resulting data payloads from standard output (stdout):

echo '{"type":"dataforseo_serp","keyword":"quantum computing trends"}' | npx @skobyn/mcp-dataforseo --config '{"username":"YOUR_CRED","password":"YOUR_SECRET"}'

Supported Query Modalities

Search Engine Results Page (SERP) Inquiry

{
  "type": "dataforseo_serp",
  "keyword": "artificial intelligence",
  "location_code": 2840,
  "language_code": "en",
  "device": "desktop",
  "os": "windows"
}

Keyword Metrics Retrieval

{
  "type": "dataforseo_keywords_data",
  "keywords": ["seo", "search engine optimization"],
  "location_code": 2840,
  "language_code": "en"
}

External Link Profile Analysis

{
  "type": "dataforseo_backlinks",
  "target": "example.com",
  "limit": 100
}

Webpage Technical Audit

{
  "type": "dataforseo_onpage",
  "url": "https://example.com",
  "check_spell": true,
  "enable_javascript": true
}

Domain Authority Assessment

{
  "type": "dataforseo_domain_analytics",
  "domain": "example.com"
}

Mobile Application Index Data

{
  "type": "dataforseo_app_data",
  "app_id": "com.example.app"
}

E-commerce Product Feed Analysis

{
  "type": "dataforseo_merchant",
  "keyword": "bluetooth speakers",
  "location_code": 2840,
  "language_code": "en"
}

Local Business Listings Lookup

{
  "type": "dataforseo_business_data",
  "keyword": "pizza delivery",
  "location_code": 2840,
  "language_code": "en"
}

Node.js Interfacing Example

Demonstration of spawning the process and communicating via streams:

const { spawn } = require('child_process');

// Initiate the external MCP server process
const serverProcess = spawn('npx', ['@skobyn/mcp-dataforseo', '--config', '{"username":"YOUR_CRED","password":"YOUR_SECRET"}']);

// Construct the desired query payload
const query = {
  type: 'dataforseo_serp',
  keyword: 'artificial intelligence'
};

// Transmit the instruction to the server's input stream
serverProcess.stdin.write(JSON.stringify(query) + '\n');
serverProcess.stdin.end();

// Capture and process successful output
serverProcess.stdout.on('data', (buffer) => {
  const result = JSON.parse(buffer.toString());
  console.log("Received Data:", result);
});

// Log operational or connection errors
serverProcess.stderr.on('data', (errorBuffer) => {
  console.error(`Process Runtime Fault: ${errorBuffer.toString()}`);
});

Configuration via Environment Variables

Authentication details can be injected environment-wide instead of through command-line arguments:

export DATAFORSEO_USERNAME=your_username_env
export DATAFORSEO_PASSWORD=your_password_env
npx @skobyn/mcp-dataforseo

Package Distribution Procedures

Steps required for deploying updates to the public npm registry:

1. Authenticate your npm account: bash npm login

2. Publish the current build publicly: bash npm publish --access public

3. For subsequent incremental updates: bash npm version patch npm publish