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.
- Clone this repository
- Install dependencies:
npm install
- Copy the environment template and fill in your DataForSEO credentials:
cp .env.template .env
- Edit
.env
and add your DataForSEO login and password
Development mode with auto-reload:
npm run dev
Production mode:
npm start
GET /health
POST /api/serp/google/organic/live
POST /api/serp/google/local_pack/live
POST /api/serp/google/news/live
POST /api/keywords/google/search_volume/live
POST /api/keywords/google/keywords_for_site/live
POST /api/keywords/google/search_suggestions/live
POST /api/domain_analytics/rank_tracking/live
POST /api/domain_analytics/domain_intersection/live
POST /api/backlinks/summary/live
POST /api/backlinks/anchors/live
POST /api/backlinks/competitors/live
POST /api/on_page/lighthouse/live
POST /api/on_page/instant_pages
POST /api/content_analysis/search/live
POST /api/content_analysis/categories
POST /api/business_data/google/my_business_info/live
POST /api/business_data/google/reviews/live
POST /api/app_data/google/app_info/live
POST /api/app_data/google/app_reviews/live
POST /api/merchant/google/products/live
POST /api/merchant/google/sellers/live
POST /api/dataforseo_labs/google/historical_serps/live
POST /api/dataforseo_labs/google/competitors_domain/live
POST /api/serp/google/organic/live
{
"target": "google.com",
"location_name": "United States",
"keywords": ["example search term"]
}
POST /api/keywords/google/search_volume/live
{
"keywords": [
"example keyword 1",
"example keyword 2"
],
"location_name": "United States"
}
POST /api/backlinks/summary/live
{
"target": "example.com"
}
POST /api/business_data/google/reviews/live
{
"business_id": "ChIJ...",
"location_name": "United States"
}
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"
}
}
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.