The DataForSEO MCP Server provides a standardized interface to access multiple SEO-related APIs for comprehensive data retrieval and analysis:
- SERP API: Retrieve real-time search results from Google, Bing, and Yahoo with available location data
- KEYWORDS_DATA API: Access keyword research metrics including search volume, CPC, and clickstream data
- BACKLINKS API: Analyze backlink profiles, referring domains, anchor text usage, and track changes over time
- ONPAGE API: Crawl websites to gather SEO performance metrics
- DATAFORSEO_LABS API: Access proprietary keyword, SERP, and domain databases
- BUSINESS_DATA API: Collect business reviews from platforms like Google, Trustpilot, and Tripadvisor
- DOMAIN_ANALYTICS API: Identify website technologies and access Whois data
- Customization: Enable/disable specific modules via environment variables and extend with new tools
Provides access to Google SERP data through DataForSEO's SERP API, allowing retrieval of real-time search engine results including titles, descriptions, and URLs.
Supports server implementation built on Node.js, requiring v14 or higher for handling DataForSEO API requests and responses.
Offers a TypeScript-based implementation for creating and extending tools that interact with DataForSEO APIs.
Utilizes Zod for schema validation of API parameters, ensuring properly structured requests to the DataForSEO endpoints.
DataForSEO MCP Server
Model Context Protocol (MCP) server implementation for DataForSEO, enabling Claude to interact with selected DataForSEO APIs and obtain SEO data through a standardized interface.
Features
- SERP API: real-time Search Engine Results Page (SERP) 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: allows crawling websites and webpages according to customizable parameters to obtain on-page SEO performance metrics;
- DATAFORSEO_LABS API: data on keywords, SERPs, and domains based on DataForSEO's in-house databases and proprietary algorithms.
Prerequisites
- Node.js (v14 or higher)
- DataForSEO API credentials (API login and password)
Installation
- Clone the repository:
- Install dependencies:
- Set up environment variables:
Installation as an NPM Package
You can install the package globally:
Or run it directly without installation:
Remember to set environment variables before running the command:
Building and Running
Build the project:
Run the server:
HTTP Server Configuration
The server runs on port 3000 by default and supports both Basic Authentication and environment variable-based authentication.
To start the HTTP server, run:
Authentication Methods
- Basic Authentication
- Send requests with Basic Auth header:
- Credentials format:
username:password
- Environment Variables
- If no Basic Auth is provided, the server will use credentials from environment variables:
Available Modules
The following modules are available to be enabled/disabled:
SERP
: real-time SERP data for Google, Bing, and Yahoo;KEYWORDS_DATA
: keyword research and clickstream data;ONPAGE
: crawl websites and webpages to obtain on-page SEO performance metrics;DATAFORSEO_LABS
: data on keywords, SERPs, and domains based on DataForSEO's databases and algorithms;BACKLINKS
: data on inbound links, referring domains and referring pages for any domain, subdomain, or webpage;BUSINESS_DATA
: based on business reviews and business information publicly shared on the following platforms: Google, Trustpilot, Tripadvisor;DOMAIN_ANALYTICS
: helps identify all possible technologies used for building websites and offers Whois data;
Adding New Tools/Modules
Module Structure
Each module corresponds to a specific DataForSEO API:
SERP
module → SERP APIKEYWORDS_DATA
module → Keywords Data APIONPAGE
module → OnPage APIDATAFORSEO_LABS
module → DataForSEO Labs APIBACKLINKS
: module → Backlinks APIBUSINESS_DATA
: module → Business Data APIDOMAIN_ANALYTICS
: module → Domain Analytics API
Implementation Options
You can either:
- Add a new tool to an existing module
- Create a completely new module
Adding a New Tool
Here's how to add a new tool to any new or pre-existing module:
Creating a New Module
- Create a new directory under
src/modules/
for your module:
- Create module files:
- Register your module in
src/config/modules.config.ts
:
- Initialize your module in
src/index.ts
:
What endpoints/APIs do you want us to support next?
We're always looking to expand the capabilities of this MCP server. If you have specific DataForSEO endpoints or APIs you'd like to see supported, please:
- Check the DataForSEO API Documentation to see what's available
- Open an issue in our GitHub repository with:
- The API/endpoint you'd like to see supported;
- A brief description of your use case;
- Describe any specific features you'd like to see implemented.
Your feedback helps us prioritize which APIs to support next!
Resources
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that enables Claude to interact with DataForSEO APIs, allowing access to SEO data including SERPs, keyword research, on-page metrics, and domain analytics.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables web search, scraping, crawling, and content extraction through multiple engines including SearXNG, Firecrawl, and Tavily.Last updated -3511TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables Claude to perform Google Custom Search operations by connecting to Google's search API.Last updated -Python
- -securityFlicense-qualityA stdio-based server that enables interaction with the DataForSEO API through the Model Context Protocol, allowing users to fetch SEO data including search results, keywords data, backlinks, on-page analysis, and more.Last updated -145JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to perform web research by integrating Google search, extracting webpage content, and capturing screenshots.Last updated -8544MIT License