Guía para instalar OpenSEO con Docker, DataForSEO y Claude SEO

Cómo instalar OpenSEO: la guía definitiva de SEO con IA sin depender de Ahrefs

Instalar OpenSEO es la forma más rápida de tener un panel de keywords, auditorías y rank tracking dentro de Claude, sin pagar una suscripción como la de Ahrefs. Hay dos caminos: la cuenta hospedada, que se conecta en pocos minutos, y la instalación autoalojada con Docker, que te deja pagar solo por consumo. En esta guía verás los dos, cómo conectarlos a Claude y cuándo conviene cada uno.

¿Qué es OpenSEO y de dónde salen sus datos?

OpenSEO es una plataforma SEO open source que cubre investigación de keywords, rank tracking, backlinks, auditorías y visibilidad en IA. No tiene datos propios: todo viene de la API de DataForSEO, que se paga por consumo.

Puedes usarlo de dos formas: la versión hospedada en openseo.so o tu propia instalación con Docker. Si dudas, empieza por la primera y pasa a Docker cuando tu consumo crezca.

OpciónQué pagasCuándo conviene
Hospedada (openseo.so)Créditos de OpenSEO; suma un 28 % a cada consulta a DataForSEOProbar rápido, sin instalar nada
Autoalojada (Docker)Solo el saldo de DataForSEO y el equipo donde corra el contenedorVarios clientes o consumo frecuente

Opción 1: instalar OpenSEO con tu cuenta hospedada (la forma fácil)

Es el camino más corto: no instalas nada en tu equipo y OpenSEO consume DataForSEO por ti. La cuenta nueva incluye un pequeño saldo de prueba que no se renueva.

1. Crea tu cuenta en OpenSEO

Entra a app.openseo.so, regístrate y abre tu panel. Verás un proyecto por defecto donde ya puedes explorar Keyword Research, Domain Overview y Backlinks.

2. Agrega el conector en Claude

En Claude abre Customize → Connectors → Add custom connector y escribe OpenSEO como nombre. Pega esta URL del servidor MCP:

https://app.openseo.so/mcp

Pulsa Continuar y aprueba el inicio de sesión en el navegador. El plan Free de Claude permite un solo conector personalizado.

Con un plan de pago puedes instalar el plugin oficial, que además incluye los skills de SEO. Ve a Customize → Plugins → Add marketplace → Add from a repository, pega https://github.com/every-app/open-seo e instala OpenSEO.

3. Comprueba la conexión

Abre un chat nuevo y escribe: «Usa OpenSEO para revisar mi conexión y listar mis proyectos». Si no tienes proyectos, pídele que cree uno con el dominio de tu sitio; crear un proyecto no gasta créditos.

Después prueba con una sola tarea a la vez:

  • «Usa OpenSEO para auditar mi sitio y dime los 5 problemas más importantes.»
  • «Investiga keywords para [tu servicio] en [tu ciudad] y guarda las 20 mejores.»
  • «Compara mi sitio con [competidor.com] en keywords y backlinks.»

Qué gasta créditos y qué no

  • Gratis: crear proyectos, guardar el contexto del negocio, conectar Search Console y Analytics, y enviar URLs por IndexNow.
  • Consume créditos: la investigación de keywords y SERPs, y las consultas nuevas a ChatGPT u otros modelos de IA.

El saldo de prueba alcanza para pocas consultas, así que pídele a Claude el costo estimado antes de las tareas grandes. Cuando se agote, puedes seguir con la opción 2.

Opción 2: instalar OpenSEO autoalojado con Docker

Aquí no pagas a OpenSEO: solo el saldo de DataForSEO y el equipo donde corra el contenedor. Es la mejor opción si manejas varios clientes o consultas con frecuencia.

Requisitos

  • Docker Desktop (Windows o macOS) o Docker Engine con Docker Compose.
  • Git para clonar el repositorio.
  • Una cuenta de DataForSEO con tus credenciales de API.

Paso 1: consigue tus credenciales de DataForSEO

DataForSEO cobra solo por consumo, sin plan mensual. Según su página de precios, el depósito mínimo es de 50 USD, el saldo no expira y al registrarte te dan 1 USD para probar. Confirma estos montos antes de depositar, porque pueden cambiar.

En su panel abre la sección de acceso a la API y copia tu login y tu password de API. No son los de tu cuenta.

Paso 2: clona el repositorio

git clone https://github.com/every-app/open-seo.git
cd open-seo
cp .env.example .env

El último comando crea tu archivo de configuración a partir de la plantilla.

Paso 3: pega tu key en el archivo .env

Abre .env y asigna tu credencial a DATAFORSEO_API_KEY. El valor es login:password codificado en base64. Confirma el formato en docs/DATAFORSEO_API_KEY.md del repositorio.

En Linux o macOS la generas así:

echo -n "tu-login:tu-password-api" | base64

En Windows, desde PowerShell:

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("tu-login:tu-password-api"))

Paso 4: levanta el contenedor

docker compose up -d

Abre http://localhost:3001 en tu navegador. Ese es el puerto por defecto y puedes cambiarlo con la variable PORT.

Conecta tu instancia a Claude

Los clientes MCP inician sesión con las mismas cuentas del panel web. En Claude agrega un conector personalizado con la URL MCP de tu propia instancia, según la guía oficial de MCP de OpenSEO.

Instalar OpenSEO en un VPS (Ubuntu)

Un VPS mantiene OpenSEO encendido las 24 horas y le da una URL pública, algo que localhost no puede ofrecer. Necesitas un servidor con Ubuntu 22.04 o 24.04, 2 GB de RAM o más y acceso por SSH.

1. Conéctate e instala Docker. El script oficial deja Docker y Docker Compose listos en un solo paso.

ssh root@IP_DE_TU_VPS
curl -fsSL https://get.docker.com | sh

2. Clona el repositorio y configura la key. Es el mismo proceso de los pasos 2 y 3. Genera la key en base64 con el comando de Linux y pégala en DATAFORSEO_API_KEY.

git clone https://github.com/every-app/open-seo.git
cd open-seo
cp .env.example .env
nano .env

3. Levanta el contenedor. Después comprueba que responde en el propio servidor.

docker compose up -d
curl -I http://localhost:3001

4. Publícalo con HTTPS. Apunta un subdominio (por ejemplo openseo.tudominio.com) a la IP del VPS e instala Caddy siguiendo su guía oficial para Ubuntu. Caddy obtiene y renueva el certificado solo.

openseo.tudominio.com {
    reverse_proxy localhost:3001
}

Abre solo los puertos 22, 80 y 443 en el firewall. Docker publica sus puertos saltándose UFW, así que revisa en docker-compose.yml que el puerto 3001 quede ligado a 127.0.0.1:3001:3001 y no a todo internet.

5. Protege el acceso y conéctalo a Claude. Si tu versión arranca con AUTH_MODE=local_noauth, cualquiera con la URL podría gastar tu saldo de DataForSEO. Activa la autenticación según la documentación del repositorio antes de publicarlo, y después agrega la URL MCP de tu dominio como conector personalizado en Claude.

Seguridad y actualizaciones

Según la versión, el contenedor puede iniciar sin inicio de sesión (AUTH_MODE=local_noauth). Si lo vas a exponer fuera de tu equipo, ponlo detrás de un proxy con autenticación, un túnel o una red privada.

Para actualizar, descarga la imagen nueva y reinicia el contenedor:

docker compose pull
docker compose up -d

OpenSEO y Claude SEO: cómo se reparten el trabajo

Claude SEO es la capa de análisis: automatiza auditorías técnicas, de contenido y de visibilidad en IA desde Claude Code. OpenSEO aporta los datos y el seguimiento de posiciones. Si aún no lo tienes, aprende a instalar Claude SEO en Claude Code.

  • OpenSEO: keywords, SERPs, backlinks, rank tracking y proyectos guardados.
  • Claude SEO: auditoría, prioridades y plan de acción.
  • Search Console: tus clics e impresiones reales. Aquí te explicamos cómo conectar Google Search Console a Claude Code.

Para seguir ampliando tu entorno, revisa nuestra lista de skills y MCP para Claude Code.

¿Puede OpenSEO sustituir a Ahrefs?

Para keywords, SERPs, auditorías y rank tracking, la combinación suele alcanzar. El punto débil son los backlinks.

  • Índice de backlinks: Ahrefs tiene su propio crawler, y los datos de backlinks de DataForSEO no tienen por qué coincidir con los suyos.
  • Métricas propias: no tendrás el DR ni el Keyword Difficulty de Ahrefs, sino equivalentes de DataForSEO que no son comparables.
  • Reportes para clientes: quienes ya conocen Ahrefs suelen confiar más en sus cifras.

Un complemento gratuito es Ahrefs Webmaster Tools, que muestra los backlinks de los sitios que verificas como tuyos. Prueba OpenSEO con el saldo de prueba y compara antes de decidir.

Preguntas frecuentes

¿Cuál es la forma más fácil de instalar OpenSEO?

Crear una cuenta en app.openseo.so y agregarla como conector personalizado en Claude con la URL https://app.openseo.so/mcp. No instalas nada ni necesitas una key de DataForSEO.

¿Necesito una API key de DataForSEO para usar OpenSEO?

Con la versión hospedada de openseo.so no, porque OpenSEO la consume por ti y suma un 28 % a cada consulta. Si lo autoalojas, sí necesitas tu propia key y pagas a DataForSEO directamente.

¿DataForSEO tiene plan mensual?

No. Se paga por consumo con un depósito mínimo de 50 USD y el saldo no expira, según su página de precios.

¿Cómo instalar OpenSEO en Windows con Docker?

Instala Docker Desktop y Git, clona el repositorio, copia .env.example a .env y pega tu key en DATAFORSEO_API_KEY. Después ejecuta docker compose up -d y abre http://localhost:3001.

¿Cómo instalar OpenSEO en un VPS?

Instala Docker en tu servidor Ubuntu, clona el repositorio y pega tu key en .env. Levanta el contenedor con docker compose up -d y publícalo con un proxy HTTPS como Caddy, con la autenticación activada, para conectarlo a Claude.

¿Puede OpenSEO reemplazar a Ahrefs?

Para keywords, auditorías y rank tracking suele alcanzar. En backlinks, Ahrefs conserva la ventaja por su índice propio.

Publicaciones Similares