SEO Tools MCP Server

A comprehensive stdio MCP (Model Context Protocol) server for SEO APIs. This server allows LLMs (Large Language Models) to interact with DataForSEO API functions and other SEO tools.

Overview

The SEO Tools MCP Server enables seamless integration between LLMs like Claude and various SEO APIs, making it possible to perform SEO analysis, keyword research, backlink analysis, and many other SEO-related tasks directly through natural language interactions.

This implementation exposes all major DataForSEO API endpoints as MCP tools, which LLMs can call to retrieve specific SEO data. The server uses stdio as its transport layer, making it easy to integrate with various LLM platforms.

Features

Comprehensive coverage of DataForSEO API endpoints
Optional integration with Local Falcon and other third-party SEO tools
Stdio transport for easy integration
Authentication handling
Detailed error reporting
Type-safe tool definitions with Zod schemas
Extensible architecture for adding new API integrations

Implemented API Categories

DataForSEO API

SERP API - Search engine results data from Google, Bing, Yahoo, and more
Keywords Data API - Keyword research, suggestions, and search volume data
DataForSEO Labs API - Advanced SEO analytics, domain comparisons, and keyword analysis
Backlinks API - Backlink profiles, referring domains, and anchor text analysis
OnPage API - Website audit, content analysis, and technical SEO checks
Domain Analytics API - Technology stack detection and domain data analysis
Content Analysis API - Content quality evaluation and semantic analysis
Content Generation API - AI-powered content generation tools
Merchant API - E-commerce data from Amazon and Google Shopping
App Data API - Mobile app data from Google Play and App Store
Business Data API - Business listing data from Google My Business, Trustpilot, and more

Local Falcon API (Optional)

Calculate Grid Points - Generate grid coordinates for local ranking analysis
Search GMB Locations - Find Google My Business locations by query
Get Ranking at Coordinate - Check business ranking at specific coordinates
Keyword Search at Coordinate - Test search terms at specific locations
Run Grid Search - Perform full grid-based local ranking analysis

Installation

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Usage

To use this MCP server, you need API credentials for the services you want to use.

Running the Server with DataForSEO

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

Running the Server with DataForSEO and Local Falcon

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

Using with Claude or other LLMs

This server implements the Model Context Protocol, which allows LLMs to interact with external systems in a standardized way. To use it with Claude, you'll need to integrate it with your LLM platform according to their specific MCP implementation.

See the examples directory for usage examples.

Development

# Run in development mode with hot reloading
npm run dev

Examples

Check out the examples directory for sample code showing how to use the SEO Tools MCP Server.

The basic example demonstrates:

Starting the server
Connecting to it from a client
Making calls to different API endpoints
Handling the results

Available Tools

The server exposes hundreds of tools across all integrated API categories. Below are some examples of the most commonly used tools:

DataForSEO SERP API Tools

serp_google_organic_live - Get Google organic search results
serp_google_organic_task_post - Create a Google organic search task
serp_google_maps_live - Get Google Maps search results

DataForSEO Keywords Data Tools

keywords_google_ads_search_volume - Get search volume for keywords
keywords_google_ads_keywords_for_site - Get keyword suggestions for a domain
keywords_google_trends_explore - Explore keyword trends over time

DataForSEO Labs Tools

labs_google_keyword_ideas - Get keyword ideas based on seed keywords
labs_google_related_keywords - Get related keywords
labs_google_domain_rank_overview - Get domain ranking overview

DataForSEO Backlinks Tools

backlinks_summary - Get a summary of a domain's backlink profile
backlinks_backlinks - Get a list of backlinks for a domain
backlinks_referring_domains - Get referring domains for a target

Local Falcon Tools (If Configured)

localfalcon_calculate_grid_points - Calculate grid points around a base coordinate
localfalcon_search_gmb_locations - Search for Google My Business locations
localfalcon_get_ranking_at_coordinate - Get business ranking at specific coordinate
localfalcon_keyword_search_at_coordinate - Search keywords at a specific location
localfalcon_run_grid_search - Run a full grid search for local rankings

Complete Tool List

For a complete list of all available tools and their parameters, check the implementation in the src/api directory.

Extending the Server

The server is designed to be extensible. To add support for additional SEO APIs:

Create a new directory in src/api/ for your integration
Implement client handling and tool registration
Add your integration to src/index.ts
Add environment variable handling for authentication

See the Local Falcon integration in src/api/localfalcon/ for a template.

License

MIT

Integrations