DataForSEO MCP

Model Context Protocol (MCP) server implementation for DataForSEO, enabling AI assistants to interact with DataForSEO APIs and obtain SEO data through a standardized interface.

Features

Provides access to comprehensive SEO data through multiple specialized APIs:

• AI Optimization API: Data for keyword discovery, conversational optimization, and real-time LLM benchmarking
• SERP API: Real-time Search Engine Results Page data for Google, Bing, and Yahoo
• Keywords Data API: Keyword research and clickstream data, including search volume, cost-per-click, and other metrics
• OnPage API: Website and webpage crawling with customizable parameters to obtain on-page SEO performance metrics
• DataForSEO Labs API: Data on keywords, SERPs, and domains based on DataForSEO's proprietary databases and algorithms
• Backlinks API: Comprehensive backlink analysis including referring domains, anchor text distribution, and link quality metrics
• Business Data API: Publicly available data on business entities from Google, Trustpilot, and Tripadvisor
• Domain Analytics API: Website traffic data, technology detection, and Whois details
• Content Analysis API: Brand monitoring, sentiment analysis, and citation management data

Module Configuration

You can selectively enable specific API modules using the ENABLED_MODULES environment variable:

export ENABLED_MODULES="SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS"

Available modules:

• AI_OPTIMIZATION
• SERP
• KEYWORDS_DATA
• ONPAGE
• DATAFORSEO_LABS
• BACKLINKS
• BUSINESS_DATA
• DOMAIN_ANALYTICS
• CONTENT_ANALYSIS

Response Customization

The server supports flexible response filtering:

• Full Response Mode: Set DATAFORSEO_FULL_RESPONSE="true" to receive complete, unmodified API responses
• Simple Filter Schema: Set DATAFORSEO_SIMPLE_FILTER="true" for LLMs that cannot handle nested structures (required for ChatGPT APIs)
• Field Configuration: Use a JSON configuration file to specify exactly which fields to return for each tool

Deployment Options

NPX (Local)

npx dataforseo-mcp-server

HTTP Server

npx dataforseo-mcp-server http

Runs on port 3000 with support for Basic Authentication or environment variable-based authentication.

Cloudflare Worker

Deploy as a serverless, edge-distributed worker:

wrangler deploy --main build/index-worker.js

Provides global edge distribution with auto-scaling and supports both Streamable HTTP and SSE transports.

Authentication

Requires DataForSEO API credentials. Supports two authentication methods:

1. Environment Variables (recommended for local use)
2. Basic Authentication (for HTTP server mode)

Resources

• DataForSEO API Documentation
• Model Context Protocol Documentation