Construí un plugin de WordPress que entiende de qué trata tu contenido (no solo sus tags)

Construí un sistema de related posts con IA para WordPress que usa embeddings en vez de tags — acá cuento cómo funciona y por qué importa

Llevo un tiempo dándole vueltas a un problema que me molesta cada vez que reviso los “artículos relacionados” de casi cualquier sitio WordPress: casi nunca son relevantes de verdad.

El motivo es simple. La inmensa mayoría de los plugins de related posts —incluidos varios “con IA” en el nombre— en realidad comparan tags y categorías compartidas. Si dos artículos no tienen ni una etiqueta en común, el plugin los ignora, aunque hablen exactamente de lo mismo.

Así que hice lo que suelo hacer cuando un problema me parece resoluble: lo construí.

El problema, en concreto

Imagina un artículo sobre “cómo bajar de peso corriendo” y otro sobre “rutina de running para principiantes”. Un lector de uno probablemente quiere leer el otro — el contenido está profundamente relacionado. Pero si el primero tiene el tag fitness y el segundo running, la mayoría de los plugins de related posts no los conecta nunca.

El problema no es de etiquetado. Es que estos plugins nunca entienden de qué trata el artículo. Solo comparan metadatos.

La solución: related posts con IA embeddings

La alternativa técnica no es nueva — es la misma tecnología detrás de la búsqueda semántica moderna (la que usan buscadores internos avanzados y sistemas de recomendación serios): embeddings.

En términos simples, un embedding convierte el contenido de un artículo en un vector numérico que representa su significado. Dos artículos que tratan temas similares generan vectores matemáticamente cercanos, sin importar si comparten una sola palabra o etiqueta.

Cuando busqué si existía algo así ya empaquetado como plugin de WordPress, listo para instalar, me encontré con que la oferta era prácticamente inexistente. Hay plugins de búsqueda semántica, sí — pero related posts calculados por embeddings, casi nada. Y en español, directamente nada.

Así nació Semantic Related Posts, que empaqueto y lanzo bajo mi estudio, Juanjo Labs.

Qué hace el plugin

• Calcula la similitud semántica real entre tus artículos usando embeddings de IA sobre el contenido completo (no solo título o extracto)
• También incluye 3 modos adicionales si no quieres depender solo de IA: por categoría, por etiquetas, o un modo híbrido que combina ambos con re-ranking por IA
• Actualiza las recomendaciones automáticamente vía cron, sin trabajo manual
• Se integra con Rank Math para generar metadata SEO (meta title, meta description, ALT de imágenes) automáticamente, en español y otros idiomas
• Funciona con WooCommerce y custom post types, no solo posts de blog

Hay una versión Lite gratuita (embeddings sobre título/extracto, hasta 200 posts) para que cualquiera pueda probar el enfoque sin comprometerse. Y una versión Premium con contenido completo, posts ilimitados, más estilos de widget y la integración de metadata SEO con IA para Rank Math.

(Nota: el envío a WordPress.org está en revisión al momento de escribir esto — un proceso que puede tardar semanas. Mientras tanto, tanto la versión Lite como la Premium están disponibles para descarga directa más abajo, sin esperar esa aprobación.)

Qué necesitas para que funcione

Ninguna de las dos versiones cobra por el uso de IA en sí — usas tu propia cuenta y tu propia cuota, directo con cada proveedor. El plugin nunca intermedia esos costos ni los cobra a través de la licencia.

• Voyage AI (embeddings, obligatorio para el modo IA semántica, ambas versiones): tiene un tier gratuito mensual, suficiente para la mayoría de blogs medianos. Te registras en dash.voyageai.com y pegas tu API key en el panel del plugin.
• Claude/Anthropic (solo Premium, opcional): se usa exclusivamente para generar la metadata SEO con IA (título, descripción, ALT de imágenes) de forma más precisa. Si no configuras esta key, la metadata SEO se sigue generando igual, pero con reglas simples en vez de IA — no es un requisito duro, es una mejora opcional. Te registras en console.anthropic.com.

Si prefieres no usar IA para nada, también están los modos por categoría y por etiquetas (sin necesidad de ninguna API key, funcionan al instante) — ver la sección de arriba.

Por qué lo cuento acá

Este blog siempre ha sido el lugar donde documento lo que construyo, no solo lo que opino. Si administras un sitio WordPress y te ha pasado lo mismo que a mí —related posts que no tienen sentido— probablemente vale la pena que lo pruebes.

Si lo instalas y tienes feedback, comentarios o casos raros donde no funcione como esperas, contáctame — este es justo el tipo de producto que mejora con uso real, no con specs en una página de ventas.

Descarga / compra:

(Cuando se apruebe en WordPress.org, la versión Lite también va a estar disponible ahí — actualizaré este post con el link en ese momento.)

---

¿Tienes un sitio WordPress y quieres probar el plugin antes del lanzamiento oficial? Escríbeme en los comentarios o envíame un email jjegonzalezf@gmail.com