Command Room

Suite de SEO técnico todo en uno para WordPress: metas, datos estructurados, sitemaps, redirecciones, robots.txt, control de bots de IA, monitor de 404, limpieza HTTP/permalinks, breadcrumbs, atributos automáticos de imágenes, componentes de front-end orientados a SEO, e integración opcional con Google Search Console y Chrome UX Report (CrUX) — todo en un único panel de administración.

• Requiere: WordPress 6.2+, PHP 7.4+
• Licencia: GPLv2 o posterior
• Idioma: el plugin y este documento están en español; no hay archivos .pot/i18n todavía, todo el texto está en el código.

Este documento tiene dos partes: una guía de uso pantalla por pantalla (para quien va a administrar el plugin desde wp-admin) y una guía técnica de arquitectura (para quien vaya a mantener o extender el código).

Índice

1. Qué resuelve y por qué existe
2. Instalación
3. El concepto clave: de la IA de pago dentro del plugin, a un plugin gratuito conectado con tu agente de IA
4. Guía de uso — pantalla por pantalla
5. Arquitectura (para desarrolladores)
6. Estado del proyecto y limitaciones conocidas

Qué resuelve y por qué existe

Command Room resuelve, sobre todo, un problema de conexión entre el SEO y las herramientas de IA. El plugin está construido para que cualquier agente de IA de programación (Claude Code, Cursor, Copilot o el que uses) pueda leerlo y modificarlo directamente: cada plantilla de metas es un único bloque de HTML editable, cada bloque de schema es JSON plano, cada ajuste vive en una opción con nombre claro, y cada módulo sigue el mismo patrón de dos piezas (una que guarda, otra que imprime). Ese código limpio y predecible es lo que permite mantener siempre el control real sobre lo que se imprime en el sitio, aunque la interfaz de administración esté deliberadamente simplificada frente a Rank Math o Yoast — a pesar de tener bastantes más opciones en abierto y gratis (bots de IA, Core Web Vitals vía CrUX, componentes de front-end, importadores, etc.).

Esa simplicidad no es una limitación: es lo que hace que el plugin sea fiable y flexible de verdad. Al no depender de decenas de pantallas ni de una estructura de datos opaca, puedes cederle a tu agente de programación tareas como "añade esta meta", "crea este bloque de JSON-LD" o "monta un módulo nuevo" sin miedo a que rompa algo en tu web — el propio diseño del plugin (opciones simples, un patrón repetido en todos los módulos, sin lógica escondida) está pensado para que ese trabajo sea seguro. Con instalar el plugin y darle a tu agente unas pocas indicaciones concretas, la optimización de un sitio pasa de ser sesiones enteras de configuración manual a cuestión de minutos.

Instalación

1. Sube la carpeta command-room a /wp-content/plugins/ (por FTP/SSH, o subiendo el .zip desde "Plugins → Añadir nuevo → Subir plugin").
2. Actívalo desde "Plugins".
3. Entra en el nuevo menú lateral "Command Room" para configurar cada módulo.
4. Si vienes de Rank Math o Yoast: usa el importador en Configuración → Herramientas antes de activar nada. Trae plantillas de metas y redirecciones sin borrar ni tocar los datos originales del otro plugin.
5. Activa "Salida en el sitio" módulo a módulo (dentro de Configuración → Herramientas) solo cuando hayas verificado cada uno con su vista previa.
6. Antes de dar el salto real, apaga Rank Math/Yoast — ver la siguiente sección, es el paso que más problemas evita.

El concepto clave: de la IA de pago dentro del plugin, a un plugin gratuito conectado con tu agente de IA

Rank Math, Yoast y la mayoría de plugins de SEO grandes han empezado a vender su propia capa de IA como función de pago: generación de metas, sugerencias de contenido, "asistentes" varios, casi siempre por créditos o suscripción, y siempre como una caja cerrada — no ves ni puedes tocar cómo decide lo que decide. Command Room parte de la idea contraria: en vez de meter un asistente de IA de pago dentro del plugin, el plugin entero está diseñado para que cualquier agente de IA que ya uses para programar pueda leerlo, entenderlo y modificarlo directamente. Gratis, sin marketplace de créditos, sin caja negra.

Esto cambia quién resuelve tus necesidades de SEO. No es una función empaquetada, limitada a lo que el fabricante del plugin decidió ofrecer este trimestre: es tu propio agente, con contexto completo de tu sitio, escribiendo exactamente el meta, el bloque de schema o el módulo que necesitas, sobre una base de código pensada específicamente para que eso sea seguro. Es la diferencia entre pagar por una IA genérica metida dentro de un SaaS ajeno, y tener un plugin gratuito que es, en sí mismo, terreno fácil de trabajar para la IA que ya tienes corriendo en tu editor o tu terminal.

En la práctica, esto significa que Command Room está pensado para sustituir a Rank Math/Yoast, no para convivir con ellos indefinidamente. El camino de migración es:

1. Instala Command Room y usa el importador (Configuración → Herramientas) para traer tus metas, plantillas y redirecciones desde Rank Math o Yoast sin perder nada.
2. Ajusta lo que haga falta — a mano o pidiéndoselo a tu agente de IA — con la salida real todavía apagada, comparando en paralelo contra lo que ya tenías.
3. Cuando todo cuadre, activa la salida real y desactiva el otro plugin de SEO.

Ese último paso es el único punto delicado de la migración: si activas la salida real de Command Room sin haber desactivado antes el otro plugin, ambos imprimen su propio <title>, <meta description> y <link rel="canonical"> en la misma página — HTML inválido y una señal confusa para los buscadores. Para que eso no pase por descuido, Configuración → Herramientas → "Salida en el sitio" muestra siempre, arriba del todo, una tarjeta de estado: si Rank Math o Yoast siguen activos, aparece un aviso con un botón "Desactivar Rank Math" / "Desactivar Yoast SEO" que los apaga con un clic (con confirmación), sin salir del admin ni tocar SSH/WP-CLI — el último empujón para completar la sustitución sin dejar HTML duplicado por el camino.

Los módulos que no dependen de un plugin de SEO de terceros para lo mismo (Robots.txt, Servidor/Limpieza, Componentes, Código, Auto-Image SEO, Breadcrumbs) no tienen este interruptor — se aplican en cuanto guardas, porque no hay un "otro plugin" con el que puedan chocar de la misma forma.

Guía de uso — pantalla por pantalla

El menú lateral "Command Room" tiene diez entradas. Las que agrupan varias pantallas antiguas lo dicen explícitamente.

General

El dashboard. Siete bloques, cada uno opcional/colapsable:

1. Rendimiento GSC — gráfica de clics/impresiones/CTR/posición con selector 7/28/90 días, si has conectado Google Search Console (ver "Configuración → Herramientas" más abajo).
2. Patrones de éxito — cuatro comparaciones automáticas sobre tus propios datos de Search Console (evolución de posición por categoría, CTR de páginas con año en el título, impresiones de páginas con FAQ, crecimiento de páginas con intención de compra). Cada patrón compara una cosa distinta; no es un único algoritmo.
3. Tabla de módulos — resumen de todos los módulos del plugin con su toggle de visibilidad en el menú.
4. Top URLs — tus páginas con más clics, vía Search Console.
5. Auditoría del sitio — chequeos reales sobre contenido real (meta descripción ausente, título duplicado, imagen destacada sin alt, enlaces internos rotos, H1 ausente, URLs con parámetros indexadas). Escanea hasta 200 entradas, con caché de 24h y botón "Actualizar auditoría". Documentado con sus propios falsos positivos conocidos (p. ej. "H1 ausente" puede saltar si tu tema pinta el H1 fuera del contenido).
6. Análisis y legibilidad — heurísticas (no un analizador lingüístico real) sobre la última entrada publicada: densidad aproximada de palabra clave, estructura H2/H3, enlaces entrantes, longitud de frases/párrafos, voz pasiva.
7. Problemas recientes + Privacidad — la píldora "Sin llamadas externas" solo aparece si ni GSC ni CrUX están conectados.

Nada de esto requiere cuenta de Google salvo los puntos 1 y 2 (Search Console) — son completamente opcionales.

Metas

Plantillas de <title>, meta descripción, canonical, robots, Open Graph y Twitter Cards, en un único bloque de HTML editable por grupo de página (no campo por campo): Home, Contenido, Categorías, Tags, Autor, Corporativas, General (aplicado como base a todo lo que no tenga su propio grupo). Cada bloque usa variables tipo %title%, %sitename%, %sep%, %author_name%, %url%, %robots%, %image%, etc. — el listado completo y qué significa cada una está en la pestaña Variables del menú (no lo dupliques buscándolo en el código). Permite override manual por entrada individual desde el metabox del editor.

Datos estructurados

Constructor de JSON-LD (@graph) por los mismos 7 grupos de página que Metas. Cada grupo admite varios bloques a la vez (p. ej. una entrada puede llevar Article + FAQPage + HowTo juntos, todos dentro del mismo @graph, nunca como `