Documentación para desarrolladores
Plugin de WordPress
El plugin lleva la auditoría de MonoRanks a WordPress: las puntuaciones y correcciones del sitio en una pantalla de MonoRanks, las puntuaciones de cada página en la lista de entradas, contenido hacia MonoRanks, correcciones aprobadas de vuelta y cada escritura con Undo.
Instalar y conectar
- En WordPress, ve a Plugins → Añadir plugin (Añadir nuevo en versiones antiguas de WordPress), busca MonoRanks, haz clic en Instalar ahora y luego en Activar. El plugin está en WordPress.org.
- En MonoRanks, abre el sitio web, ve a Integrations, haz clic en Connect WordPress y luego en Connect to WordPress.
- WordPress te pide que apruebes MonoRanks. Haz clic en Sí, apruebo esta conexión. MonoRanks activa el plugin si está instalado pero inactivo, le entrega su clave del conector y pide la primera sincronización de contenido. Si el plugin aún no está instalado, MonoRanks guarda tu aprobación y muestra Finish setup: instala el plugin y luego haz clic ahí. No hace falta una segunda aprobación.
- La página Integrations del sitio web muestra el conector de WordPress como conectado, con la versión del plugin y la última sincronización.
Lo que ves en WordPress
El plugin añade un menú MonoRanks al panel de administración de WordPress.
- Overview: las puntuaciones de salud y AEO del sitio con su cambio desde la semana pasada, los clics de búsqueda de los últimos 28 días (de Google Search Console, cuando está conectado en MonoRanks), las páginas que más atención necesitan, las correcciones que aprobaste en MonoRanks listas para aplicar con un clic (Apply o Apply all) y los últimos cambios escritos en el sitio, cada uno con Undo.
- Settings: el estado de la conexión, la clave del conector, la última sincronización, lo que se envía y se lee de vuelta, y el registro completo de cambios.
- Una columna MonoRanks en Entradas, Páginas y otros tipos de contenido: los anillos de puntuación de salud y AEO de cada página. Pasa el ratón por un anillo para ver las correcciones pendientes, los problemas abiertos y cuándo se auditó la página. Un anillo AEO vacío significa que la página no se revisó, no que tenga mala puntuación: AEO se mide en las páginas más importantes de cada auditoría. La columna se ordena por salud, y la vista “Needs attention” lista las páginas publicadas por debajo de 60.
Las puntuaciones vienen de la auditoría semanal, se leen de MonoRanks con la clave del conector y se guardan en WordPress; no se pide nada en la parte pública del sitio. Al abrir una pantalla de MonoRanks se piden en ese momento si lo guardado tiene más de una hora, así que también llegan a sitios con WP-Cron desactivado, y el resto de las páginas siguen en segundo plano. Hasta que se ejecute la primera auditoría, las pantallas lo indican.
Lo que envía el plugin
Solo metadatos del contenido publicado, por HTTPS: tipo de contenido, URL, título, un extracto de 40 palabras, nombre del autor y URL de su avatar, categorías, etiquetas, fechas, título SEO, meta descripción, URL canónica, marca de noindex y URLs de imágenes con su texto alternativo. También el estado del plugin (nombre del sitio, versión del plugin y de WordPress, plugin de SEO activo, recuentos por tipo de contenido) y avisos de cambio cuando una entrada se publica, se actualiza o se despublica.
Nunca se envía: borradores, entradas privadas o protegidas con contraseña, comentarios, correos o contraseñas de usuarios, ni ajustes de plugins o del tema.
Lo que se lee de MonoRanks, con la misma clave: solo los resultados de auditoría de este sitio web (puntuaciones del sitio y por página, problemas abiertos, las correcciones que aprobaste, clics de búsqueda), para las pantallas de arriba. La lista incluye las correcciones aprobadas que aún no se escribieron, para que el plugin pueda aplicarlas él mismo si una escritura desde MonoRanks no llegó.
Lo que escribe
Solo lo que apruebas en MonoRanks (o mediante apply en la API y MCP): títulos SEO, meta descripciones, texto alternativo de imágenes, URLs canónicas, noindex, redirecciones, un primer párrafo que responde primero, reglas de robots.txt para rastreadores de IA y un archivo llms.txt. Cada escritura queda registrada en MonoRanks → Settings en WordPress con Undo, y las páginas afectadas se revisan el mismo día.
- Cambios en el texto de la página (como el primer párrafo) se comprueban después de guardar y se deshacen si rompen un bloque, mostrando el motivo.
- Plugins de SEO. Los títulos, descripciones, canónicas y noindex van a los campos de Yoast SEO, Rank Math o The SEO Framework, o pasan por los filtros de All in One SEO; sin plugin de SEO, el plugin los imprime él mismo. Con un plugin de SEO en el que MonoRanks aún no puede escribir (SEOPress, Slim SEO, Squirrly SEO, SmartCrawl, WP Meta SEO, SEO SIMPLE PACK), esas cuatro correcciones se rechazan y MonoRanks las muestra como “no se puede escribir aquí” con el motivo. En una portada estática mandan los ajustes de portada (Homepage Settings) de The SEO Framework, así que una escritura ahí se rechaza con el motivo.
- Cachés de página. Después de cada escritura y cada deshacer, el plugin pide a la caché de página activa que descarte la página cambiada: WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, SiteGround Optimizer, WP-Optimize, Nginx Helper, Breeze, Kinsta, WP Engine y Pantheon. El plugin de Cloudflare y las cachés de CDN fuera de WordPress no se vacían. Si un cambio está escrito pero aún no aparece en la página publicada, MonoRanks muestra “Written, not live” e indica si se vació la caché de la página (plugin 0.1.18).
- llms.txt y reglas para rastreadores de IA. El plugin sirve un llms.txt aprobado en
/llms.txt, marcado para que las cachés no lo guarden. Las reglas aprobadas de permitir o bloquear para rastreadores de IA (GPTBot, ClaudeBot, PerplexityBot, Google-Extended y otros) se añaden a robots.txt. Tras cualquiera de las dos escrituras, se vacía la copia en caché de/llms.txto/robots.txty MonoRanks vuelve a leer el archivo. - Mayúsculas y minúsculas. Algunos plugins de SEO cambian las mayúsculas de los títulos, por ejemplo el ajuste Capitalize Titles de Rank Math. Un título que solo se diferencia en las mayúsculas cuenta igualmente como publicado, con una nota que explica por qué.
Las escrituras usan la contraseña de aplicación “MonoRanks” que apruebas en WordPress. Revócala en Usuarios → Perfil → Contraseñas de aplicación para detener todas las escrituras; la lectura y la sincronización de contenido siguen funcionando. Un cambio se rechaza si el valor en WordPress cambió desde que lo aprobaste. Undo está en MonoRanks durante 30 días, y cada cambio aparece en MonoRanks → Settings en WordPress. Las correcciones ya escritas se quedan en tu sitio después de desconectar.
Desconectar
Desde cualquiera de los dos lados: en MonoRanks, en Website → Integrations → WordPress → Disconnect, o en WordPress, en MonoRanks → Settings → Disconnect. Las dos formas revocan la clave del conector de este sitio web, borran las puntuaciones guardadas y detienen todos los envíos; una desconexión en WordPress avisa a MonoRanks enseguida, así que el sitio web también deja de aparecer como conectado allí. Si no llega nada de un sitio durante una semana, MonoRanks marca la conexión como inactiva por sí mismo.
Desarrolladores
El plugin es de código abierto: github.com/monoranks/wordpress-plugin. Usa la API REST con una clave de sitio web (permisos content:write, sites:read, pages:read) y lee los resultados de auditoría mediante las rutas del conector descritas en docs/api.md del repositorio. Las pantallas de administración son una app de React (Vite, Tailwind, componentes al estilo shadcn); la columna de Entradas es PHP generado en el servidor.
Preguntas frecuentes
¿El plugin ralentiza mi sitio?
No. No añade scripts ni estilos a tus páginas. En la parte pública solo imprime las etiquetas SEO aprobadas cuando ningún plugin de SEO lo hace, sirve un llms.txt aprobado y comprueba las redirecciones aprobadas al principio de la petición. El contenido se envía en segundo plano: cuando MonoRanks lo pide, cuando publicas, una vez al día y cuando abres una pantalla de MonoRanks cuyas puntuaciones guardadas tienen más de una hora.
¿Con qué plugins de SEO funciona?
Yoast SEO, Rank Math y The SEO Framework (plugin 0.1.15 o posterior): los títulos, descripciones, canónicas y noindex aprobados van a sus propios campos. All in One SEO: se le pasan mediante sus filtros. Sin plugin de SEO: el plugin imprime esas etiquetas él mismo. Con un plugin de SEO en el que MonoRanks aún no puede escribir, como SEOPress, Slim SEO o Squirrly SEO, esas cuatro correcciones se rechazan con el motivo, la pantalla de ajustes de MonoRanks en WordPress lo advierte y MonoRanks las muestra como "no se puede escribir aquí". Las demás correcciones siguen funcionando.
¿Puedo usarlo sin el conector?
Sí. MonoRanks audita cualquier sitio web público. El plugin añade correcciones con un clic y revisiones el mismo día.