What is Mcp Dataforseo

mcp-dataforseo is a Model Context Protocol server designed for interfacing with the DataForSEO API, allowing users to send and receive structured data requests and responses.

Use cases

Use cases include retrieving search engine results for specific keywords, analyzing backlinks for a website, checking on-page SEO factors, and gathering business data related to specific keywords.

How to use

To use mcp-dataforseo, you can run it directly using npx with your credentials or install it globally via npm. You send JSON requests through standard input and receive JSON responses through standard output.

Key features

Key features include support for various API request types such as SERP, Keywords Data, Backlinks, On-Page, Domain Analytics, App Data, Merchant, and Business Data APIs, along with easy integration into Node.js applications.

Where to use

mcp-dataforseo can be used in digital marketing, SEO analysis, web development, and data analytics, where structured data retrieval from search engines and websites is required.

DataForSEO MCP Server

A stdio-based Model Context Protocol (MCP) server for DataForSEO API.

Sign up for Data for Seo

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

Installation

You can run directly with npx:

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

Or install globally:

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

Usage

Send JSON requests to stdin and receive JSON responses from stdout:

echo '{"type":"dataforseo_serp","keyword":"artificial intelligence"}' | npx @skobyn/mcp-dataforseo --config '{"username":"your_username","password":"your_password"}'

Supported Request Types

SERP API

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

Keywords Data API

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

Backlinks API

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

On-Page API

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

Domain Analytics API

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

App Data API

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

Merchant API

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

Business Data API

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

Integration Example

Here’s how to use this MCP server in your Node.js code:

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

// Start the MCP server
const server = spawn('npx', ['@skobyn/mcp-dataforseo', '--config', '{"username":"your_username","password":"your_password"}']);

// Define the request
const request = {
  type: 'dataforseo_serp',
  keyword: 'artificial intelligence'
};

// Send the request
server.stdin.write(JSON.stringify(request) + '\n');
server.stdin.end();

// Process the response
server.stdout.on('data', (data) => {
  const response = JSON.parse(data.toString());
  console.log(response);
});

// Handle errors
server.stderr.on('data', (data) => {
  console.error(`Error: ${data}`);
});

Environment Variables

You can also use environment variables instead of the config:

export DATAFORSEO_USERNAME=your_username
export DATAFORSEO_PASSWORD=your_password
npx @skobyn/mcp-dataforseo

Publishing

To publish this package to npm:

1. Login to npm if not already logged in:

   npm login
   

2. Publish the package:

   npm publish --access public
   

3. To update the package later:

   npm version patch
   npm publish