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
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.
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.
⚡ Cómo funciona
- 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.
- 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.
- 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.
- 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.
![]() | |
![]() | ![]() |
![]() | ![]() |
🤖 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.
| Agente | Conectar + todas las herramientas | Constructor 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 |
| Instalar | Inicio rápido: tu propia computadora, un VPS o desde el código fuente |
| Configurar | Instalar Claude Code · Instalar Codex · Instalar Cursor · El asistente de configuración · Search Console · Datos de palabras clave · Publicación · Conecta tu sitio |
| Usarlo | Día a día · El panel · Automatizaciones · Comandos del agente |
| Referencia | Conceptos · Herramientas MCP · Variables de entorno · Horarios · Arquitectura |
| Ayuda | Solució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ándo | Tú haces | Él hace |
|---|---|---|
| Una vez a la semana, 5 minutos | Abre el panel, trabaja la cola: aprueba, rechaza, reordena | Rellena la cola con ideas investigadas y el razonamiento detrás de cada una |
| Cada mañana | Nada | Construye la idea aprobada más antigua en una solicitud de extracción en tu repositorio |
| Cuando llega una PR | Revisa 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 quieras | Pregunta 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:
| Nivel | Precio | Qué obtienes |
|---|---|---|
| Solo Search Console | $0 | Posiciones de GSC, ideas de palabras clave de Autocompletado más tus propios datos de impresiones |
| + Clave gratuita de SerpApi | $0 | Verificaciones de SERP en vivo, posiciones reales semanales (250 búsquedas gratuitas/mes) |
| + DataForSEO | pago por llamada | Volumen 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.




