# DataForSEO MCP (oficial): 8 API de SEO en una instalación, pago por uso para SERP, palabras clave, enlaces entrantes y auditorías

> Úsalo para comparar demanda de búsqueda, posiciones y competidores y elegir oportunidades de SEO prácticas.

Verificado el 24 may 2026.

## Recursos

-   [Descripción de DataForSEO MCP](https://dataforseo.com/model-context-protocol) - página oficial de MCP con la lista de módulos y una guía de inicio rápido.
-   [DataForSEO MCP en GitHub](https://github.com/dataforseo/mcp-server-typescript) - repositorio fuente, incidencias y variables de entorno.
-   [Guía de configuración de Claude](https://dataforseo.com/help-center/connect-claude-to-dataforseo-mcp-very-simple-guide) - paso a paso del centro de ayuda de DataForSEO.
-   [Precios de la API](https://dataforseo.com/pricing) - precios por llamada para cada endpoint.
-   [Documentación completa de la API](https://docs.dataforseo.com/v3/) - referencia de cada endpoint al que da acceso el MCP.

## Cómo funciona

DataForSEO vende una de las API de datos SEO para agentes más baratas del mercado y ofrece un MCP oficial que da acceso a ocho módulos (SERP, Keywords Data, OnPage, DataForSEO Labs, Backlinks, Business Data, Domain Analytics, Content Analysis) desde un solo servidor.

Cargas un monedero con un depósito mínimo de $50, configuras el MCP con tu usuario y contraseña de API y el agente puede obtener SERP, investigar palabras clave, auditar enlaces entrantes y rastrear páginas sin que conectes cada endpoint a mano.

El mecanismo menos evidente es el selector de cola: cada endpoint tiene una variante Live (en tiempo real, cara) y una variante Task (asíncrona, ~5 minutos, más barata).

Configurar Task como opción predeterminada del agente marca la diferencia entre un mes de $3 y uno de $300 con el mismo volumen.

## Paso 1: regístrate en dataforseo.com y añade el depósito mínimo

El MCP se autentica contra tu monedero de DataForSEO, así que debes cargarlo antes de que funcione la primera llamada.

Ve a [https://dataforseo.com/](https://dataforseo.com/) y crea una cuenta.

Las cuentas nuevas reciben $1 de crédito gratis, suficiente para confirmar la conexión antes de hacer un depósito.

> Abre el panel en [https://app.dataforseo.com/](https://app.dataforseo.com/). Ve a Billing y añade el depósito mínimo de $50 con tarjeta o transferencia. Los créditos no caducan, así que el depósito permanece en el monedero hasta que el agente lo consuma.

Si quieres probar sin pagar, cada endpoint tiene una variante Sandbox gratis en `https://sandbox.dataforseo.com/` que devuelve respuestas predefinidas sin costo.

## Paso 2: genera las credenciales de la API

DataForSEO usa autenticación HTTP Basic con usuario y contraseña, no un token OAuth ni una clave de API.

Las credenciales están en el panel y son únicas por cuenta, no por proyecto.

> En el panel, abre [https://app.dataforseo.com/api-access](https://app.dataforseo.com/api-access). Copia API Login (el correo de tu cuenta) y API Password (una cadena aleatoria generada por DataForSEO). Guárdalos en un gestor de contraseñas. Los pegarás en la configuración de Claude en el paso 4.

Si la contraseña se filtra, cámbiala desde la misma página; la anterior deja de funcionar inmediatamente y el MCP devuelve un 401 en la siguiente llamada.

## Paso 3: instala DataForSEO MCP

El servidor oficial está publicado en npm como `dataforseo-mcp-server` y funciona en modo stdio (para Claude Code y Claude Desktop) o HTTP (para clientes remotos).

Para Claude Code, stdio es el transporte adecuado. No necesitas instalar nada de forma global; `npx` descargará el servidor en la primera ejecución.

```
npx -y dataforseo-mcp-server
```

Si prefieres una instalación persistente o trabajas sin conexión:

```
npm install -g dataforseo-mcp-server
```

Para ejecutarlo como servidor HTTP (útil si quieres compartir un MCP entre un equipo o colocarlo detrás de un proxy inverso):

```
npx -y dataforseo-mcp-server http
```

Para la mayoría de las configuraciones de un solo desarrollador, déjalo en stdio y omite el modo HTTP.

## Paso 4: conecta las credenciales en la configuración de Claude Code

Claude Code lee los servidores MCP de la configuración de proyecto o usuario, dentro de un bloque `mcpServers`.

Abre la configuración (Claude Desktop: Developer > Edit Config; Claude Code CLI: `~/.claude.json` o `.mcp.json` por proyecto) y pega:

```
{
  "mcpServers": {
    "dataforseo": {
      "command": "npx",
      "args": ["-y", "dataforseo-mcp-server"],
      "env": {
        "DATAFORSEO_USERNAME": "your_api_login",
        "DATAFORSEO_PASSWORD": "your_api_password",
        "ENABLED_MODULES": "SERP,KEYWORDS_DATA,DATAFORSEO_LABS,BACKLINKS,ONPAGE"
      }
    }
  }
}
```

`ENABLED_MODULES` es el control de presupuesto. El MCP da acceso a nueve módulos por defecto, pero cargarlos todos ofrece al agente una superficie de herramientas enorme y ralentiza la selección.

Elige solo los módulos que realmente uses. El ejemplo anterior cubre el flujo habitual de SEO; añade `BUSINESS_DATA`, `DOMAIN_ANALYTICS` o `CONTENT_ANALYSIS` si los necesitas.

Reinicia Claude Code y confirma con:

```
claude mcp list
```

Deberías ver `dataforseo` con estado conectado.

## Paso 5: obtén una SERP para una palabra clave (verificación)

La prueba básica de funcionamiento más barata es una llamada SERP de la cola Standard, que cuesta $0.0006 (seis centésimas de centavo).

Si devuelve un conjunto de resultados real, las credenciales y la conexión de módulos son correctas.

Pega esto en Claude Code:

```
Usa DataForSEO MCP para obtener la SERP de Google en EE. UU. para equipos de escritorio con la palabra clave "ai agent frameworks". Usa el endpoint estándar basado en tareas, no el endpoint live. Devuelve los 10 primeros resultados orgánicos como una tabla con posición, título, dominio y URL.
```

El agente llamará a `serp/google/organic/task_post`, recibirá un identificador de tarea, consultará `serp/google/organic/task_get/advanced/{task_id}` hasta que esté lista (normalmente en menos de 60 segundos) y mostrará la tabla.

Si ves una lista de resultados al estilo de Ahrefs, Semrush o Surfer, la instalación funciona bien.

## Paso 6: audita los enlaces entrantes de un competidor

El módulo Backlinks factura de dos formas: $0.02 por solicitud más $0.00003 por fila devuelta, con un máximo de 1,000 filas por solicitud.

Eso significa que obtener 1,000 filas de un dominio cuesta $0.05, aproximadamente 100 veces menos que el costo equivalente en créditos de Ahrefs Site Explorer.

Pega esto en Claude Code:

```
Audita los 200 principales enlaces entrantes al dominio "openai.com" usando la API Backlinks de DataForSEO. Usa el endpoint backlinks/backlinks/live con limit=200 y order_by=rank,desc. Devuelve una tabla con la URL de la página de origen, el texto del enlace, el estado dofollow y la puntuación de rango. Después resume: los 5 principales dominios de origen por cantidad, los 3 principales grupos de textos de enlace y cualquier patrón evidente de enlaces pagados o PBN.
```

El agente llama una vez a `backlinks/backlinks/live` (200 filas = $0.02 de solicitud + $0.006 de filas = $0.026 en total) y muestra el análisis.

Live es la opción adecuada aquí porque Backlinks Live no es un rastreador en tiempo real como el de SERP; consulta el índice de enlaces almacenado de DataForSEO, así que es rápido y la variante Task no es significativamente más barata.

## Paso 7: encuentra oportunidades de palabras clave frente a 3 competidores

El módulo DataForSEO Labs tiene un endpoint de intersección de dominios que muestra palabras clave para las que se posicionan los competidores y tú no.

Es la misma consulta por la que Ahrefs Content Gap y Semrush Keyword Gap cobran una suscripción de $249 al mes, facturada aquí a unos $0.01 por llamada.

Pega esto en Claude Code:

```
Usa el MCP de DataForSEO Labs para encontrar oportunidades de palabras clave de mi dominio "mysite.com" frente a "competitor1.com", "competitor2.com" y "competitor3.com" en el índice de Google de EE. UU. Usa el endpoint dataforseo_labs/google/domain_intersection/live. Devuelve las 50 principales palabras clave para las que al menos 2 competidores estén entre los 20 primeros resultados y mi dominio no tenga ninguna posición. Ordena por volumen de búsqueda combinado de mayor a menor. Muestra el volumen de búsqueda, CPC, KD y qué competidores se posicionan para cada una.
```

Sustituye los cuatro dominios por tus objetivos reales.

El agente devuelve una lista priorizada de palabras clave que puedes incorporar directamente a un calendario de contenido.

## Paso 8: detecta cambios en las SERP de la semana pasada

DataForSEO Labs tiene un endpoint `historical_serps` que devuelve la SERP de una palabra clave en una fecha concreta, con un historial de unos dos años.

Puedes usarlo para detectar volatilidad en las posiciones (vale la pena investigar a un competidor que subió 8 puestos en una semana).

Pega esto en Claude Code:

```
Para estas 5 palabras clave (pega tu lista), usa dataforseo_labs/google/historical_serps/live para obtener la SERP de Google de EE. UU. de hace 7 días y la actual de hoy. Compara los 10 primeros resultados orgánicos de ambas instantáneas. Devuelve una tabla con la palabra clave, cualquier dominio que haya subido o bajado 3 posiciones o más, la posición actual, la posición de hace 7 días y la diferencia. Señala los nuevos dominios que entren entre los 10 primeros.
```

Obtendrás un informe de cambios de posiciones por menos de $0.10 de gasto total de API.

Ejecútalo cada semana para las palabras clave que te importan y tendrás tu propio seguimiento privado de posiciones sin costo de suscripción.

## Paso 9: control de presupuesto: prefiere los endpoints Task a los Live

La principal queja documentada sobre DataForSEO es el consumo de créditos por elegir accidentalmente la cola Live.

Live cuesta unas 3.3 veces más que Standard (Task) para SERP: $2.00 frente a $0.60 por 1,000 llamadas.

Para trabajos por lotes (cualquiera en el que puedas esperar entre 30 y 60 segundos), configura siempre el patrón basado en Task como predeterminado del agente: `serp/google/organic/task_post` para enviar y después `serp/google/organic/task_get/advanced/{id}` para recuperar.

Incorpora esta regla al agente añadiendo una línea al prompt del servidor MCP o a tu prompt de sistema:

```
Prefiere siempre los endpoints de DataForSEO basados en tareas (task_post y después task_get) a los endpoints live, salvo que el usuario diga explícitamente «en tiempo real» o «en vivo ahora». Los endpoints live cuestan entre 3 y 4 veces más para el mismo resultado.
```

Un segundo control: limita el número de filas en las llamadas a Backlinks y Labs.

El MCP obtendrá sin problema 1,000 filas cuando basten 100, y las filas se facturan individualmente.

Indica al agente que use `limit=100` por defecto en las llamadas a Labs y Backlinks, salvo que el usuario pida más.

## Paso 10: programa un informe semanal de SEO

Cuando la conexión sea estable, el uso de mayor impacto es un informe recurrente que se ejecute cada lunes y llegue a tu bandeja de entrada o a una página de Notion.

El informe combina cuatro llamadas baratas: cambios de posición de las palabras clave que sigues, nuevos enlaces entrantes a tu dominio, principales cambios de SERP en tu sector y una consulta de oportunidades de palabras clave frente a tu principal competidor.

Pega esto en Claude Code (o prográmalo como rutina de Claude):

```
Ejecuta mi informe semanal de SEO usando DataForSEO MCP. Obtén cuatro cosas y reúnelas en un informe Markdown:

1. Para las palabras clave que sigo (pega la lista), usa historical_serps para obtener la SERP de hace 7 días frente a la de hoy. Señala cualquier cambio de 3 posiciones o más de mi dominio "mysite.com".

2. Usa backlinks/backlinks/live para "mysite.com" con limit=50, ordenado por first_seen desc. Enumera los nuevos enlaces entrantes adquiridos en los últimos 7 días con dominio de origen, texto del enlace y estado dofollow.

3. Usa dataforseo_labs/google/domain_intersection/live para "mysite.com" frente a "topcompetitor.com" en EE. UU. Devuelve las 10 principales palabras clave para las que el competidor esté entre los 10 primeros y yo no tenga ninguna posición.

4. Usa dataforseo_labs/google/keyword_suggestions/live con la palabra inicial "[tu palabra clave principal]". Devuelve las 20 principales variantes de cola larga por volumen de búsqueda que tengan un KD inferior a 30.

Da formato a la salida como un único informe Markdown titulado «Informe semanal de SEO - [fecha de hoy]» con cuatro secciones numeradas.
```

Ejecútalo primero una vez de forma manual para confirmar que la salida es lo que quieres; después conviértelo en una rutina de Claude o una tarea cron.

El costo total por ejecución semanal, suponiendo listas razonables de palabras clave y competidores, queda entre $0.10 y $0.50, del mismo orden de magnitud que una taza de café, y sustituye una suscripción de herramientas de $249 al mes.
