DispatchSEO

Backend de gestión SEO autoalojable bajo licencia AGPL con un servidor MCP para investigación de palabras clave, cola de contenido y seguimiento de SERP, desarrollado para Claude Code.

Documentación

DispatchSEO logo

DispatchSEO

License: AGPL-3.0 Built for Claude Code, Codex, and Cursor Self-host in one command Join the Discord

Convierte tu agente de IA en tu gestor de SEO


DispatchSEO: una alternativa de código abierto a SEObot y Outrank.

Funciona hoy con Claude Code, Codex y Cursor: todos de primera clase, incluido el constructor nocturno sin supervisión.

Otras herramientas de SEO aprenden sobre tu producto rastreando tu página de inicio. Tu agente ya lo conoce,
así que DispatchSEO le da a ese agente la mitad que falta: investigación de palabras clave, contenido que se entrega como solicitudes de extracción y seguimiento de posiciones.

Claude Code   Codex   Cursor   MCP   GitHub   Google Search Console   Google   Docker


Install now   Read the docs   Watch the demo

Sitio web  ·  Discord  ·  Discusiones  ·  Versión alojada

El autoalojamiento no tiene limitaciones de funciones. Todo lo que hace la nube de pago,
este repositorio lo hace hoy, en tus propias cuentas, a $0.

DispatchSEO preview video - the dashboard, the queue, and a pipeline-built pull request, walked through end to end
▶ Ver la vista previa


⚡ Cómo funciona

  1. Tu IA investiga. La aplicación Claude en claude.ai, o un agente de codificación (Claude Code, Codex, Cursor), se conecta a DispatchSEO a través de MCP, lee el manual servido y extrae palabras clave de tus datos de Search Console, del Autocompletado de Google y de lo que ya sabe sobre tu producto. Las ideas llegan a una cola con el razonamiento adjunto.
  2. Tú apruebas, o no. Cada idea es una tarjeta en el panel: la palabra clave, por qué es ganable, el ángulo. Aprueba, rechaza o reordena. ¿Prefieres el piloto automático total? Activa el modo automático y omite la cola por completo.
  3. La canalización construye. Cada mañana, un trabajo programado toma la idea aprobada más antigua y la convierte en una solicitud de extracción real contra el repositorio de tu sitio: una guía o una pequeña herramienta gratuita, verificada contra la SERP en vivo y revisada por un revisor de similitud para que la página doce no se lea como la página tres.
  4. Realiza un seguimiento de lo que sucedió. Verificaciones de posiciones diarias, instantáneas de Search Console por hora, verificación de indexación y una vista de recorrido que te dice en qué etapa de SEO te encuentras realmente. Cuando un trabajo programado falla, recibes un banner rojo y un correo electrónico en lugar de silencio.

El backend es deliberadamente aburrido: estado, programación y una puerta de aprobación. El pensamiento ocurre en tu agente, donde ya vive tu conocimiento del producto.

The dashboard Home: the agent's daily briefing in plain language, the journey stage, publishing pace, and live Search Console stats for a connected site
The queue: keyword ideas with volume and difficulty, each waiting for approval or set to autoA pull request the pipeline built: target keyword, SERP gate verdict, archetype, and information-gain asset, all named in the description
Search traffic: clicks and impressions from Google Search Console, snapshotted hourlyKeyword rankings: daily position checks with 30-day trend sparklines

🤖 Qué agente de codificación

DispatchSEO habla con tu agente a través de MCP, así que "qué agente" es una pregunta real con una respuesta real, incluidas las partes que aún no están terminadas.

AgenteConectar + todas las herramientasConstructor nocturno sin supervisión
Claude Code
Codex
Cursor✅ conexión de un pegado, las 61 herramientas✅ mediante su clave API (cualquier plan genera una)
Gemini CLI · Copilot · cualquier cliente MCP

Conectar es un pegado y te da todo el conjunto de herramientas: investigación, la cola, aprobaciones, enlaces de retroceso, informes y la creación de una guía cuando la pides. El constructor nocturno es lo separado: trabajos programados que ejecutan un agente sin que nadie lo observe, y los tres lo hacen. Cada flujo de trabajo lleva a cada agente y pregunta al panel cuál ejecutar, así que cambiar de agente tiene efecto en la siguiente ejecución programada sin cambios en el repositorio.

La diferencia honesta es quién paga: Claude Code funciona con una suscripción que ya tienes, Cursor funciona con la clave API de tu plan de Cursor y Codex se factura por OpenAI por ejecución.

También puedes omitir los agentes de codificación por completo. Añade DispatchSEO a la aplicación Claude normal en claude.ai como conector personalizado y tu Claude hará la investigación y la escritura con la suscripción que ya tienes, luego entregará el artículo al backend para que lo verifique, termine y publique. No construirá herramientas interactivas ni ejecutará el constructor nocturno, y claude.ai debe poder alcanzar tu instalación, así que esa ruta requiere una URL pública en lugar de una computadora portátil. ChatGPT no puede conectarse todavía.

docs/AGENTS.md tiene los detalles, los niveles de soporte y cómo añadir un agente.

✅ Lo que necesitas antes de empezar

  • Un lugar para publicar. O WordPress que alojes tú mismo, conectado una vez desde Configuración con una contraseña de aplicación y publicado directamente, o el código fuente de tu sitio en un repositorio de GitHub, donde el contenido llega como solicitudes de extracción. Wix, Squarespace, Shopify, Webflow y Ghost no tienen ninguna de las dos puertas y no funcionarán.
  • Una IA que lo impulse. Tu IA es el motor, y puede ser la aplicación Claude normal en claude.ai o un agente de codificación. Claude Code funciona con la suscripción de Claude que ya pagas; Codex y Cursor hacen todo lo que Claude Code hace aquí, incluido el constructor nocturno. Codex se factura por OpenAI por ejecución, y las construcciones de Cursor usan el uso incluido de tu plan de Cursor. Consulta la tabla anterior.
  • Una máquina con Docker (~1 GB de RAM). Una computadora portátil sirve para una prueba, pero una máquina que permanezca encendida es mucho mejor para el uso diario: un VPS de $5, una Raspberry Pi, un escritorio que nunca duerme. Los horarios solo se ejecutan mientras la máquina está encendida.
  • Acceso a Google Search Console para tu sitio.

Esa es toda la lista. Sin claves API que comprar y sin cuenta de nuestro lado.

📖 Documentación

Todo está en dispatchseo.com/docs: cada página, cada configuración, cada herramienta.

Nuevo aquíQué es DispatchSEO · Cómo funciona · Nube o autoalojamiento
InstalarInicio rápido: tu propia computadora, un VPS o desde el código fuente
ConfigurarInstalar Claude Code · Instalar Codex · Instalar Cursor · El asistente de configuración · Search Console · Datos de palabras clave · Publicación · Conecta tu sitio
UsarloDía a día · El panel · Automatizaciones · Comandos del agente
ReferenciaConceptos · Herramientas MCP · Variables de entorno · Horarios · Arquitectura
AyudaSolución de problemas · Preguntas frecuentes · Seguridad · Actualización

¿Apuntando un agente a esto? Añade .md a cualquier URL de documentación para obtener markdown limpio, o obtén todo el conjunto de documentación en una sola solicitud: llms-full.txt. Hay un índice en llms.txt y un SKILL.md que guía a un agente a través de la conexión de un sitio.

¿Atascado durante la configuración? La página de solución de problemas cubre los errores que la gente realmente encuentra. Si el tuyo no está allí, pregunta en el Discord o en Discusiones: las preguntas reciben respuesta y generalmente se convierten en una corrección de documentación.

🗓️ Uso día a día

Una vez que el asistente termina, el ciclo es pequeño a propósito:

CuándoTú hacesÉl hace
Una vez a la semana, 5 minutosAbre el panel, trabaja la cola: aprueba, rechaza, reordenaRellena la cola con ideas investigadas y el razonamiento detrás de cada una
Cada mañanaNadaConstruye la idea aprobada más antigua en una solicitud de extracción en tu repositorio
Cuando llega una PRRevisa y fusiona (o deja que la fusión automática lo haga)Registra la página, solicita la indexación, comienza a rastrear su palabra clave
Cuando quierasPregunta a tu agente: "investiga palabras clave para mí", "¿qué debería escribir a continuación?", "¿cómo estamos en posiciones?"Responde con datos en vivo a través de MCP: el mismo estado que muestra el panel

La página de inicio del panel siempre nombra la siguiente acción, así que no tienes que averiguar qué hacer cuando lo abres.

🧰 Qué incluye

  • Servidor MCP con el conjunto completo de herramientas: la cola, palabras clave, posiciones, páginas, estadísticas de GSC, prospectos de enlaces de retroceso, temas de tendencia, perfil del sitio. Cualquier cosa que el panel pueda hacer, tu agente puede hacerla a través de MCP; la paridad entre ambos es una regla estricta en este código base.
  • Radar de tendencias: escanea temas en aumento en tu nicho, expande un tema en ángulos concretos de guía y pon los buenos en la cola.
  • Constructores de guías y herramientas: las guías se publican como máximo una por día, planas y permanentes (para que una cola de treinta ideas aprobadas no se convierta en treinta publicaciones en una semana); las ideas de herramientas gratuitas se construyen tras la aprobación.
  • Manual de enlaces de retroceso: una lista de prospectos precargada con el texto de tu producto, rastreada por envío.
  • Multi-sitio: una implementación gestiona cualquier número de sitios. Cada proyecto tiene su propio token MCP, sus propios datos, su propia configuración.
  • Un panel protegido por contraseña para el único humano en el ciclo.

💵 Cuánto cuesta ejecutarlo

Nada, a menos que quieras datos de pago. Los niveles se acumulan:

NivelPrecioQué obtienes
Solo Search Console$0Posiciones de GSC, ideas de palabras clave de Autocompletado más tus propios datos de impresiones
+ Clave gratuita de SerpApi$0Verificaciones de SERP en vivo, posiciones reales semanales (250 búsquedas gratuitas/mes)
+ DataForSEOpago por llamadaVolumen de búsqueda, dificultad de palabras clave, clasificación de dominio

El modo gratuito encuentra palabras clave que puedes ganar. El modo de pago también sabe cuáles valen la pena ganar.

☁️ Versión en la nube

Hay una versión alojada para quienes prefieren no ejecutar una máquina: nosotros la alojamos, incluimos los datos de SERP + volumen en una sola factura y reemplazamos el ritual de la cuenta de servicio de Google con un clic. Está en dispatchseo.com. El autoalojamiento sigue siendo completo en funciones de cualquier manera: la nube vende conveniencia, no capacidad.

🧑‍💻 Desarrollo desde el código fuente

git clone https://github.com/NeoZi12/dispatchseo
cd dispatchseo
pnpm install
cp .env.local.example .env.local
pnpm dev

Este es el camino del colaborador, no la forma de autoalojar: esa es la instalación de Docker de un comando detrás del botón en la parte superior. Completa .env.local (Supabase + los tres secretos) antes de comenzar, luego abre el panel en localhost:3000.

pnpm build es la verificación de tipos: ejecútala antes de abrir una PR. No hay configuración separada de lint o pruebas.

🏗️ Arquitectura, brevemente

Next.js App Router, Postgres para el estado (un contenedor incluido cuando se auto-aloja, Supabase en la versión en la nube), mcp-handler para el servidor MCP en /api/mcp. Los horarios y las compilaciones se ejecutan dentro del stack (cron + contenedores de compilación) o en GitHub Actions. Una implementación es multiinquilino: el token bearer de MCP selecciona el proyecto, los crons recorren todos los proyectos, el panel cambia con una cookie.

Architecture cubre esto correctamente. CLAUDE.md tiene las convenciones completas; está escrito para agentes, lo cual resulta ser una documentación decente para personas.

🤝 Contribuciones

Issues antes que PRs, y debes entender cada línea que envías, incluidas las asistidas por IA. Detalles en CONTRIBUTING.md. Las preguntas van a Discussions o al Discord; las vulnerabilidades se reportan mediante reporte privado.

📄 Licencia

AGPL-3.0. Úsalo, auto-alójalo, hazle fork. Si ejecutas una versión modificada como servicio, comparte el código fuente. Ese es todo el trato.


Construido por NeoZi12 · Si DispatchSEO te resulta útil, una ⭐ ayuda a que otras personas lo encuentren.