MCP DataForSEO Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP DataForSEO Server get backlinks summary for example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP DataForSEO Server
Servidor MCP que expone la API de DataForSEO como herramientas globales para Claude Code.
Version: 2.1.0
Herramientas Disponibles (24)
Herramientas Basicas (5)
Herramienta | Descripcion | API Requerida |
| Posicion actual de un dominio para una keyword | SERP API |
| Volumen de busqueda y metricas de keywords | Keywords Data API |
| Resumen del perfil de backlinks | Backlinks API |
| Competidores SEO por backlinks compartidos | Backlinks API |
| Domain Rank (autoridad) de un dominio | Backlinks API |
DataForSEO Labs - Keyword Research (5) - NUEVO
Herramienta | Descripcion | API Requerida |
| Dificultad de posicionamiento (0-100) | DataForSEO Labs API |
| Sugerencias de keywords relacionadas | DataForSEO Labs API |
| Clasificacion de intencion de busqueda | DataForSEO Labs API |
| Todas las keywords que posiciona un dominio | DataForSEO Labs API |
| Competidores por overlap de keywords | DataForSEO Labs API |
OnPage & Lighthouse (2) - NUEVO
Herramienta | Descripcion | API Requerida |
| Auditoria SEO on-page instantanea | OnPage API |
| Core Web Vitals y metricas Lighthouse | OnPage API |
Backlinks Avanzados (3) - NUEVO
Herramienta | Descripcion | API Requerida |
| Distribucion de anchor texts | Backlinks API |
| Backlinks ganados y perdidos en periodo | Backlinks API |
| Lista detallada de dominios que enlazan | Backlinks API |
Contenido y Tendencias (3)
Herramienta | Descripcion | API Requerida |
| Sentimiento de contenido para keyword | Content Analysis API |
| Datos de Google Trends | Keywords Data API |
| Tecnologias detectadas en un dominio | Domain Analytics API |
Analisis Avanzado (6) - NUEVO v2.1.0
Herramienta | Descripcion | API Requerida |
| Keywords compartidas entre dos dominios | DataForSEO Labs API |
| Estimacion de trafico organico para dominios | DataForSEO Labs API |
| Keywords que un sitio targeta (basado en contenido) | DataForSEO Labs API |
| Ranking historico de un dominio | DataForSEO Labs API |
| Ideas de keywords a partir de seeds | DataForSEO Labs API |
| Keywords semanticamente relacionadas | DataForSEO Labs API |
Related MCP server: DataForSEO MCP Server
Ejemplos de Uso
Keyword Research
get_keyword_difficulty
mcp__dataforseo__get_keyword_difficulty(
keywords=["neon personalizado", "letrero led", "cartel luminoso"],
country_code="ES"
)Respuesta:
{
"country": "ES",
"keywords": [
{
"keyword": "neon personalizado",
"keyword_difficulty": 42,
"search_volume": 1900,
"competition_level": "MEDIUM"
},
{
"keyword": "letrero led",
"keyword_difficulty": 58,
"search_volume": 3200,
"competition_level": "HIGH"
}
]
}get_keyword_suggestions
mcp__dataforseo__get_keyword_suggestions(
seed_keyword="neon personalizado",
country_code="ES",
limit=10
)Respuesta:
{
"seed_keyword": "neon personalizado",
"suggestions": [
{
"keyword": "neon personalizado con nombre",
"search_volume": 480,
"keyword_difficulty": 35,
"cpc": 0.52
},
{
"keyword": "neon personalizado barato",
"search_volume": 320,
"keyword_difficulty": 28,
"cpc": 0.41
}
]
}get_search_intent
mcp__dataforseo__get_search_intent(
keywords=["comprar neon personalizado", "como hacer neon casero", "neon personalizado"],
country_code="ES"
)Respuesta:
{
"keywords": [
{
"keyword": "comprar neon personalizado",
"search_intent": "transactional",
"intent_probability": 0.92
},
{
"keyword": "como hacer neon casero",
"search_intent": "informational",
"intent_probability": 0.88
},
{
"keyword": "neon personalizado",
"search_intent": "commercial",
"intent_probability": 0.75
}
]
}get_ranked_keywords
mcp__dataforseo__get_ranked_keywords(
domain="espacioneon.com",
country_code="ES",
limit=20
)Respuesta:
{
"domain": "espacioneon.com",
"total_count": 1250,
"keywords": [
{
"keyword": "neon personalizado",
"position": 8,
"url": "https://espacioneon.com/producto/neon-personalizado/",
"search_volume": 1900,
"cpc": 0.45
}
]
}get_serp_competitors
mcp__dataforseo__get_serp_competitors(
keywords=["neon personalizado", "letrero neon", "neon led"],
country_code="ES",
limit=10
)Respuesta:
{
"keywords": ["neon personalizado", "letrero neon", "neon led"],
"competitors": [
{
"domain": "neonsigns.es",
"avg_position": 4.2,
"intersections": 3
},
{
"domain": "letrerosneon.com",
"avg_position": 6.8,
"intersections": 3
}
]
}OnPage & Lighthouse
analyze_page_seo
mcp__dataforseo__analyze_page_seo(url="https://espacioneon.com/producto/neon-personalizado/")Respuesta:
{
"url": "https://espacioneon.com/producto/neon-personalizado/",
"status_code": 200,
"title": "Neon Personalizado - Disena tu Letrero LED | EspacioNeon",
"meta_description": "Crea tu neon personalizado online...",
"h1": ["Neon Personalizado"],
"word_count": 1250,
"images_count": 8,
"images_without_alt": 2,
"internal_links": 45,
"external_links": 3,
"load_time": 2.3,
"errors": [],
"warnings": ["no_image_alt: 2"]
}get_page_lighthouse
mcp__dataforseo__get_page_lighthouse(
url="https://espacioneon.com/",
device="mobile"
)Respuesta:
{
"url": "https://espacioneon.com/",
"device": "mobile",
"scores": {
"performance": 72,
"accessibility": 88,
"best-practices": 92,
"seo": 95
},
"core_web_vitals": {
"largest-contentful-paint": {
"score": 65,
"value": "2.8 s",
"numeric_value": 2800
},
"cumulative-layout-shift": {
"score": 95,
"value": "0.05",
"numeric_value": 0.05
},
"total-blocking-time": {
"score": 70,
"value": "320 ms",
"numeric_value": 320
}
},
"opportunities": [
{
"id": "render-blocking-resources",
"title": "Eliminate render-blocking resources",
"savings": 850
}
]
}Backlinks Avanzados
get_anchor_texts
mcp__dataforseo__get_anchor_texts(domain="espacioneon.com", limit=20)Respuesta:
{
"domain": "espacioneon.com",
"total_anchors": 187,
"anchors": [
{
"anchor": "espacioneon",
"backlinks": 45,
"referring_domains": 38
},
{
"anchor": "neon personalizado",
"backlinks": 28,
"referring_domains": 22
},
{
"anchor": "click here",
"backlinks": 12,
"referring_domains": 10
}
]
}get_new_lost_backlinks
mcp__dataforseo__get_new_lost_backlinks(
domain="espacioneon.com",
date_from="2026-01-01",
date_to="2026-02-01"
)Respuesta:
{
"domain": "espacioneon.com",
"date_from": "2026-01-01",
"date_to": "2026-02-01",
"summary": {
"new_backlinks": 124,
"lost_backlinks": 38,
"new_referring_domains": 18,
"lost_referring_domains": 5
},
"timeseries": [
{
"date": "2026-01-15",
"new_backlinks": 8,
"lost_backlinks": 2
}
]
}get_referring_domains
mcp__dataforseo__get_referring_domains(
domain="espacioneon.com",
limit=10,
order_by="rank"
)Respuesta:
{
"domain": "espacioneon.com",
"total_referring_domains": 187,
"referring_domains": [
{
"domain": "periodico.com",
"rank": 75,
"backlinks": 3,
"dofollow": 3,
"nofollow": 0,
"first_seen": "2025-06-15"
}
]
}Contenido y Tendencias
analyze_content_sentiment
mcp__dataforseo__analyze_content_sentiment(keyword="neon personalizado", country_code="ES")Respuesta:
{
"keyword": "neon personalizado",
"sentiment_distribution": {
"positive": 0.65,
"neutral": 0.28,
"negative": 0.07
},
"connotations": [
{"type": "decoracion", "count": 45},
{"type": "regalo", "count": 28},
{"type": "negocio", "count": 22}
]
}get_keyword_trends
mcp__dataforseo__get_keyword_trends(
keywords=["neon personalizado", "letrero led"],
country_code="ES"
)Respuesta:
{
"keywords": ["neon personalizado", "letrero led"],
"trends": [
{
"date": "2025-12-01",
"values": [{"keyword": "neon personalizado", "value": 85}]
},
{
"date": "2026-01-01",
"values": [{"keyword": "neon personalizado", "value": 72}]
}
]
}get_domain_technologies
mcp__dataforseo__get_domain_technologies(domain="espacioneon.com")Respuesta:
{
"domain": "espacioneon.com",
"technologies": [
{"name": "WordPress", "category": "CMS", "version": "6.4"},
{"name": "WooCommerce", "category": "Ecommerce", "version": "8.2"},
{"name": "Cloudflare", "category": "CDN"},
{"name": "Google Analytics", "category": "Analytics"}
],
"categories": {
"CMS": ["WordPress"],
"Ecommerce": ["WooCommerce"],
"CDN": ["Cloudflare"],
"Analytics": ["Google Analytics"]
}
}Analisis Avanzado (NUEVO v2.1.0)
get_domain_intersection
mcp__dataforseo__get_domain_intersection(
domain1="espacioneon.com",
domain2="competidor.com",
country_code="ES",
limit=20
)Respuesta:
{
"domain1": "espacioneon.com",
"domain2": "competidor.com",
"total_count": 156,
"keywords": [
{
"keyword": "neon personalizado",
"search_volume": 1900,
"competition": 0.45,
"cpc": 0.52,
"domain1_position": 8,
"domain1_url": "https://espacioneon.com/producto/neon-personalizado/",
"domain2_position": 3,
"domain2_url": "https://competidor.com/neon-custom/"
},
{
"keyword": "letrero led personalizado",
"search_volume": 880,
"domain1_position": 12,
"domain2_position": 7
}
]
}estimate_traffic
mcp__dataforseo__estimate_traffic(
domains=["espacioneon.com", "competidor1.com", "competidor2.com"],
country_code="ES"
)Respuesta:
{
"country": "ES",
"domains": [
{
"domain": "espacioneon.com",
"estimated_traffic": 4500,
"keywords_count": 1250,
"estimated_cost": 2800
},
{
"domain": "competidor1.com",
"estimated_traffic": 12000,
"keywords_count": 3400,
"estimated_cost": 8500
}
]
}get_keywords_for_site
mcp__dataforseo__get_keywords_for_site(
domain="espacioneon.com",
country_code="ES",
limit=20
)Respuesta:
{
"domain": "espacioneon.com",
"total_count": 2450,
"keywords": [
{
"keyword": "neon personalizado con nombre",
"search_volume": 480,
"competition": 0.35,
"cpc": 0.42,
"keyword_difficulty": 32
}
]
}get_historical_rank
mcp__dataforseo__get_historical_rank(
domain="espacioneon.com",
country_code="ES"
)Respuesta:
{
"domain": "espacioneon.com",
"country": "ES",
"history": [
{
"date": "2025-12-01",
"keywords_count": 1150,
"estimated_traffic": 3800,
"pos_1": 12,
"pos_2_3": 45,
"pos_4_10": 180,
"pos_11_20": 320
},
{
"date": "2026-01-01",
"keywords_count": 1250,
"estimated_traffic": 4500,
"pos_1": 15,
"pos_2_3": 52,
"pos_4_10": 210,
"pos_11_20": 340
}
]
}get_keyword_ideas
mcp__dataforseo__get_keyword_ideas(
keywords=["neon personalizado", "letrero led"],
country_code="ES",
limit=10
)Respuesta:
{
"seed_keywords": ["neon personalizado", "letrero led"],
"total_count": 450,
"ideas": [
{
"keyword": "neon personalizado bar",
"search_volume": 320,
"competition": 0.28,
"cpc": 0.38,
"keyword_difficulty": 25,
"search_intent": "commercial"
},
{
"keyword": "letrero led cocina",
"search_volume": 210,
"keyword_difficulty": 22,
"search_intent": "commercial"
}
]
}get_related_keywords
mcp__dataforseo__get_related_keywords(
keyword="neon personalizado",
country_code="ES",
limit=10
)Respuesta:
{
"seed_keyword": "neon personalizado",
"total_count": 280,
"related_keywords": [
{
"keyword": "cartel neon personalizado",
"search_volume": 590,
"competition": 0.42,
"cpc": 0.48,
"keyword_difficulty": 38,
"se_type": "google",
"depth": 1
},
{
"keyword": "luz neon decorativa",
"search_volume": 420,
"keyword_difficulty": 35,
"depth": 2
}
]
}Costos Aproximados
Categoria | Herramientas | Costo/Request |
SERP API |
| ~$0.002 |
Keywords Data |
| ~$0.005/kw |
DataForSEO Labs |
| ~$0.003-0.010 |
DataForSEO Labs (Advanced) |
| ~$0.005-0.015 |
Backlinks |
| ~$0.002-0.005 |
OnPage |
| ~$0.005-0.015 |
Content Analysis |
| ~$0.005 |
Domain Analytics |
| ~$0.002 |
Manejo de Errores
El servidor MCP devuelve mensajes de error claros:
Quota Exceeded
⚠️ Quota Exceeded: DataForSEO quota exceeded or insufficient balance
Check your DataForSEO balance at https://app.dataforseo.com/API Not Available
📦 API Not Available: This API endpoint is not available in your subscription.
To activate this API:
1. Go to https://app.dataforseo.com/
2. Navigate to Billing → API Products
3. Activate the required API (pay-as-you-go)Authentication Error
🔐 Authentication Error: Invalid DataForSEO credentials
Verify DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD environment variables.Requisitos de API por Herramienta
API DataForSEO | Herramientas | Como Activar |
SERP API |
| Activado por defecto |
Keywords Data API |
| Activado por defecto |
DataForSEO Labs API |
| Billing → API Products |
Backlinks API |
| Billing → API Products |
OnPage API |
| Billing → API Products |
Content Analysis API |
| Billing → API Products |
Domain Analytics API |
| Billing → API Products |
Instalacion
cd /Users/kevin/Documents/Desarrollo\ y\ Codigos/mcp-dataforseo
uv syncConfiguracion en Claude Code
Agregar a ~/.claude/settings.json:
{
"mcpServers": {
"dataforseo": {
"command": "uv",
"args": ["--directory", "/Users/kevin/Documents/Desarrollo y Codigos/mcp-dataforseo", "run", "mcp-dataforseo"],
"env": {
"DATAFORSEO_LOGIN": "tu_login",
"DATAFORSEO_PASSWORD": "tu_password"
}
}
}
}Paises Soportados
ES, MX, AR, CO, US, GB, DE, FR, IT, PT, NL, BE, AT, CH, IE, PL, CZ, SE, DK, NO, FI, GR, HU, RO, BG, HR, SK, SI, LT, LV, EE, BR, CL, PE
Estructura del Proyecto
mcp-dataforseo/
├── pyproject.toml
├── src/
│ └── mcp_dataforseo/
│ ├── __init__.py
│ ├── server.py # Servidor MCP con 24 herramientas
│ └── client.py # Cliente API con retry y error handling
└── README.mdCombinacion con GSC
DataForSEO complementa GSC aportando datos que GSC no tiene:
Necesito... | Usar |
Posicion actual exacta (tiempo real) | DataForSEO |
Impresiones y CTR de mi sitio | GSC |
Volumen de busqueda de keywords | DataForSEO |
Quick wins (paginas con potencial) | GSC |
Dificultad de keywords | DataForSEO |
Intencion de busqueda | DataForSEO |
Keywords que posiciona competidor | DataForSEO |
Analisis de backlinks | DataForSEO Backlinks tools |
Core Web Vitals | DataForSEO |
Changelog
2.1.0 (2026-02-05)
6 nuevas herramientas (24 total) basadas en patrones del servidor oficial
get_domain_intersection: Keywords compartidas entre dos dominios (analisis competitivo)estimate_traffic: Estimacion de trafico organico bulk para multiples dominiosget_keywords_for_site: Keywords que un sitio targeta basado en contenidoget_historical_rank: Ranking historico con distribucion de posicionesget_keyword_ideas: Ideas de keywords con intencion de busquedaget_related_keywords: Keywords semanticamente relacionadas
2.0.0 (2026-02-05)
13 nuevas herramientas (18 total)
DataForSEO Labs API: keyword difficulty, suggestions, search intent, ranked keywords, SERP competitors
OnPage API: page SEO audit, Lighthouse/Core Web Vitals
Advanced Backlinks: anchor texts, new/lost backlinks, referring domains
Content Analysis: sentiment analysis
Keywords Data: Google Trends
Domain Analytics: technology detection
Retry con exponential backoff para errores transitorios
Excepciones personalizadas (QuotaExceededError, APINotAvailableError)
Mensajes de error claros con instrucciones de activacion de API
1.1.0 (2026-02-05)
Documentacion ampliada con ejemplos de respuesta
1.0.0 (2026-02-04)
Version inicial con 5 herramientas basicas
Available Tools
24 toolsanalyze_content_sentimentA
Analyze sentiment of content related to a keyword. Returns positive/negative/neutral distribution and connotations.
Inputs: keyword (required), country_code.
analyze_page_seoA
Perform an instant on-page SEO audit of a URL. Returns title, meta, headings, word count, images, links, and technical issues.
Inputs: url (required).
check_serp_positionB
Check the current Google ranking position for a domain on a specific keyword. Returns position, URL, title, and SERP features.
Inputs: domain (required), keyword (required), depth, country_code.
estimate_trafficA
Estimate monthly organic traffic for one or more domains. Returns estimated visitors, keyword counts, and traffic value.
Inputs: domains (required), country_code.
find_competitorsA
Find SEO competitors for a domain based on shared backlinks. Returns competitor domains with relevance scores.
Inputs: domain (required), limit.
get_anchor_textsA
Get anchor text distribution for a domain's backlinks. Useful for link profile analysis and identifying over-optimization.
Inputs: domain (required), limit.
get_backlinks_summaryA
Get backlink profile summary for a domain. Returns total backlinks, referring domains, domain rank, and more.
Inputs: domain (required).
get_domain_intersectionA
Get keywords where both domains rank in the same SERP. Essential for competitive analysis - shows shared keyword opportunities with positions for both domains.
Inputs: domain1 (required), domain2 (required), limit, country_code.
get_domain_rankB
Get the Domain Rank (authority metric) for a domain. Returns rank score, backlink count, and referring domains.
Inputs: domain (required).
get_domain_technologiesA
Detect technologies used by a domain. Returns CMS, analytics, CDN, frameworks, and other detected technologies.
Inputs: domain (required).
get_historical_rankA
Get historical ranking overview for a domain. Shows how organic presence changed over time: traffic, keyword counts, position distribution.
Inputs: domain (required), country_code.
get_keyword_difficultyA
Get keyword difficulty scores (0-100) for keywords. Higher scores mean harder to rank. Also returns search volume and competition level.
Inputs: keywords (required), country_code.
get_keyword_ideasB
Get keyword ideas based on seed keywords. Uses DataForSEO's algorithm to find related opportunities with volume, difficulty, and intent.
Inputs: keywords (required), limit, country_code.
get_keywords_for_siteA
Get keywords a site potentially targets based on its content. Different from get_ranked_keywords - analyzes site content for keyword opportunities.
Inputs: domain (required), limit, country_code.
get_keyword_suggestionsB
Get keyword suggestions based on a seed keyword. Returns related keywords with volume, difficulty, and CPC.
Inputs: seed_keyword (required), limit, country_code.
get_keyword_trendsA
Get Google Trends data for keywords. Shows search interest over time for seasonality and trend analysis.
Inputs: keywords (required), date_from, country_code.
get_new_lost_backlinksA
Monitor backlinks gained and lost over a time period. Useful for tracking link building efforts and detecting negative SEO.
Inputs: domain (required), date_to (required), date_from (required).
get_page_lighthouseA
Get Lighthouse/Core Web Vitals metrics for a URL. Returns performance, accessibility, SEO scores, LCP, FID, CLS, and optimization opportunities.
Inputs: url (required), device.
get_ranked_keywordsB
Get all keywords that a domain ranks for in Google. Returns keywords with positions, URLs, and search volumes.
Inputs: domain (required), limit, country_code.
get_referring_domainsA
Get detailed list of domains linking to a target. Returns domain authority, backlink counts, dofollow ratio, and dates.
Inputs: domain (required), limit, order_by.
get_search_intentA
Classify search intent of keywords: informational, commercial, transactional, or navigational. Returns intent type with probability score.
Inputs: keywords (required), country_code.
get_serp_competitorsA
Find competitors based on SERP overlap. Given a list of keywords, returns domains that rank for the same keywords.
Inputs: keywords (required), limit, country_code.
research_keywordsB
Get search volume and competition metrics for keywords. Returns volume, CPC, competition level, and monthly trends.
Inputs: keywords (required), country_code.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Several tools have overlapping purposes, especially in keyword research: get_keyword_suggestions, get_keyword_ideas, get_related_keywords, and research_keywords all return related keywords and can be easily confused. Additionally, get_serp_competitors and find_competitors both identify competitors but via different signals, adding to ambiguity.
Most tools follow a get_ prefix pattern, but there are notable deviations such as analyze_content_sentiment, check_serp_position, find_competitors, research_keywords, and estimate_traffic. The mix of verbs is not chaotic since all names are snake_case and readable, but the pattern is inconsistent.
With 24 tools, the count falls in the 16-25 range that feels heavy. While each tool covers a specific SEO data point, the significant overlap in keyword research tools adds unnecessary bulk and reduces the overall scoping quality.
The server covers a comprehensive set of SEO capabilities including keyword research, rankings, backlinks, competitors, page audits, and traffic estimation. There are minor gaps such as the lack of a full SERP results retrieval tool, but agents can work around these with the existing tools.
Maintenance
Related MCP Connectors
Live SEO intelligence, rank tracking, site audits, and backlink analysis for AI agents.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
SEO & GEO data: keywords, live SERPs with AI Overviews, backlinks, site audits, rank tracking.
SEO data for AI agents: keywords, SERPs, rank tracking, audits, backlinks, GSC and AI visibility.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.10010,352 npm83MIT
- AlicenseCqualityNot gradedmaintenanceEnables AI assistants to interact with DataForSEO APIs and obtain SEO data including SERP results, keyword research, on-page metrics, backlink analysis, and domain analytics through a standardized interface.7610,352 npm-
- -licenseCqualityNot gradedmaintenanceEnables AI assistants to access comprehensive SEO data through DataForSEO APIs, including SERP results, keyword research, backlink analysis, on-page metrics, and domain analytics. Supports real-time search engine data from Google, Bing, and Yahoo with customizable filtering and multiple deployment options.36-
- FlicenseNot gradedqualityDmaintenanceEnables professional SEO/SEM research with geolocalized keyword discovery, competitor analysis, and SERP ranking insights using DataForSEO API.-