DataForSEO MCP Server

This is a MCP (Managed Connection Point) server for DataForSEO API integration. It provides a comprehensive interface to access all DataForSEO services including SERP data, keyword research, backlinks analysis, and more.

Setup

1. Clone this repository
2. Install dependencies:

   npm install

3. Copy the environment template and fill in your DataForSEO credentials:

   cp .env.template .env

4. Edit .env and add your DataForSEO login and password

Running the Server

Development mode with auto-reload:

npm run dev

Production mode:

npm start

Available Endpoints

Health Check

GET /health

SERP API Endpoints

POST /api/serp/google/organic/live
POST /api/serp/google/local_pack/live
POST /api/serp/google/news/live

Keywords Data API Endpoints

POST /api/keywords/google/search_volume/live
POST /api/keywords/google/keywords_for_site/live
POST /api/keywords/google/search_suggestions/live

Domain Analytics API Endpoints

POST /api/domain_analytics/rank_tracking/live
POST /api/domain_analytics/domain_intersection/live

Backlinks API Endpoints

POST /api/backlinks/summary/live
POST /api/backlinks/anchors/live
POST /api/backlinks/competitors/live

On-Page API Endpoints

POST /api/on_page/lighthouse/live
POST /api/on_page/instant_pages

Content Analysis API Endpoints

POST /api/content_analysis/search/live
POST /api/content_analysis/categories

Business Data API Endpoints

POST /api/business_data/google/my_business_info/live
POST /api/business_data/google/reviews/live

App Data API Endpoints

POST /api/app_data/google/app_info/live
POST /api/app_data/google/app_reviews/live

Merchant API Endpoints

POST /api/merchant/google/products/live
POST /api/merchant/google/sellers/live

DataForSEO Labs API Endpoints

POST /api/dataforseo_labs/google/historical_serps/live
POST /api/dataforseo_labs/google/competitors_domain/live

Example Requests

SERP Organic Search

POST /api/serp/google/organic/live
{
  "target": "google.com",
  "location_name": "United States",
  "keywords": ["example search term"]
}

Keyword Search Volume

POST /api/keywords/google/search_volume/live
{
  "keywords": [
    "example keyword 1",
    "example keyword 2"
  ],
  "location_name": "United States"
}

Backlinks Summary

POST /api/backlinks/summary/live
{
  "target": "example.com"
}

Business Reviews

POST /api/business_data/google/reviews/live
{
  "business_id": "ChIJ...",
  "location_name": "United States"
}

Error Handling

The server includes comprehensive error handling and will return appropriate HTTP status codes along with error messages when issues occur. All API responses follow this format:

Success:

{
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "status_code": 20000,
      "status_message": "Ok.",
      "result": [
        // ... result data
      ]
    }
  ]
}

Error:

{
  "error": "Error message",
  "details": {
    "status_code": 40000,
    "status_message": "Error details"
  }
}

Rate Limiting

Please note that DataForSEO has its own rate limiting and pricing structure. Make sure to check their documentation for the latest information about rate limits and pricing for each endpoint.