mainEntityOfPage es la propiedad de Schema.org con la que declaras cuál es la entidad principal de una página web. Responde a una pregunta que la IA se hace sobre cada URL: de qué entidad trata realmente este documento. Cuando la declaras con un Q-ID de Wikidata verificado, dejas de depender de que el motor adivine y le entregas una identidad resoluble sin ambigüedad.
El problema es que la mayoría de los sitios marcan datos, pero no declaran la entidad protagonista. Publican un Organization aquí, un Article allá y un Service suelto, todos como islas desconectadas. Sin mainEntityOfPage, el grafo no tiene un punto de entrada claro, y los motores generativos quedan sin una respuesta directa a la pregunta más básica: qué es esta página.
En este artículo te explico qué es mainEntityOfPage, en qué se distingue de mainEntity, about y mentions, y por qué es la pieza que cose tu página a una entidad verificable. Al final verás cómo SemanticGEO la emite automáticamente desde tu grafo de conocimiento, sin que escribas una línea de JSON-LD a mano.
Qué es mainEntityOfPage y en qué se distingue de mainEntity, about y mentions
mainEntityOfPage vive en el nodo WebPage y apunta a la entidad principal que describe esa página. Es una referencia, no una descripción: no guarda texto, guarda un puntero con @id hacia otra entidad del grafo. Schema.org la define como la entidad principal descrita por la página, y su valor práctico es enorme porque le dice al motor cuál es el sujeto central del documento.
mainEntityOfPage apunta desde la página; mainEntity apunta desde la entidad
Son dos caras de la misma relación. La propiedad mainEntity se usa dentro de un nodo para señalar su entidad principal, por ejemplo en una FAQPage donde mainEntity apunta a la Question. mainEntityOfPage se usa en sentido inverso: desde el WebPage hacia la entidad que lo protagoniza. Cuando ambos extremos se referencian por el mismo @id, el grafo queda cosido y sin ambigüedad.
about, mentions y mainEntityOfPage: tres señales con propósitos distintos
about declara de qué trata el contenido, como tema general. mentions señala entidades que se mencionan de paso. mainEntityOfPage nombra a la entidad protagonista, la que responde a la pregunta de qué es esta página. Un artículo sobre la evolución del SEO puede tener about apuntando a search engine optimization, mentions apuntando a Google, y mainEntityOfPage apuntando al propio Article.
Por qué el schema tradicional falla sin una entidad principal declarada
La mayoría de los plugins de datos estructurados emiten bloques JSON-LD válidos pero desconectados. Cumplen con el validador de Schema.org, y aun así dejan la página sin un mainEntityOfPage que la ancle a una entidad. El resultado es el escenario que viven miles de sitios: el código valida, pero la IA no sabe quién es el protagonista, así que no tiene una entidad limpia que citar.
Sin esa referencia, un WebPage es un documento suelto, no una página que habla de una entidad. Y como los motores generativos no leen keywords sino que resuelven entidades, una página sin entidad principal es una página que la IA no puede resolver con precisión.
Nota de Entidad
La frase libre “esta página trata sobre SEO” es texto muerto para un grafo. La tripleta estructurada sí: web page (Q36774) con mainEntityOfPage apuntando a search engine optimization (Q180711), cuya descripción oficial en Wikidata es “practice and strategies of increasing online visibility in search engine results pages”. Con ese Q-ID, la IA ya no interpreta: compara y resuelve, porque el Knowledge Graph puede contrastar la entidad con Wikidata.
Cómo declarar la entidad principal con un Q-ID verificable
Declarar mainEntityOfPage bien tiene tres requisitos. Primero, la entidad apuntada debe existir en tu grafo con un @id propio, no como texto suelto. Segundo, debe estar anclada a Wikidata mediante sameAs con un Q-ID real. Tercero, el @id debe ser canónico y estable, normalizado en HTTPS, para que no se parta en dos entidades.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "WebPage",
"@id": "https://ejemplo.cl/servicios/seo/#webpage",
"url": "https://ejemplo.cl/servicios/seo/",
"mainEntityOfPage": { "@id": "https://ejemplo.cl/#service-seo" }
},
{
"@type": "Service",
"@id": "https://ejemplo.cl/#service-seo",
"name": "Consultoría SEO B2B",
"provider": { "@id": "https://ejemplo.cl/#organization" }
}
]
}Fíjate en el detalle: el WebPage no repite la descripción del servicio, solo lo referencia por @id. Esa es la diferencia entre coser un grafo y emitir islas. La entidad se define una sola vez y se referencia desde todas las páginas que la protagonizan.
La solución tecnológica: SemanticGEO
SemanticGEO emite mainEntityOfPage automáticamente como parte de su Graph Stitching sobre el grafo de Yoast SEO. Cuando creas un nodo Service o SoftwareApplication para una página, el plugin cose ese nodo al WebPage correspondiente con la referencia correcta, sin que escribas una línea de JSON-LD a mano. La entidad vive en tu biblioteca central, con su Q-ID validado en tiempo real contra la API de Wikidata, y se reutiliza en todo el sitio con el mismo @id.
El flujo es este: defines la entidad una vez, eliges el Q-ID con el buscador de Wikidata integrado, y el plugin se encarga del resto. Los 13 packs de nicho importables traen las entidades base de tu vertical ya verificadas, y el llms.txt se genera desde el mismo grafo, así que la entidad principal de cada página viaja también al resumen que leen los crawlers de IA. Cero tipeo manual, cero islas, cero @id partidos.
Preguntas frecuentes
¿mainEntityOfPage es lo mismo que la URL canónica?
No. La URL canónica resuelve cuál de varias versiones de una misma página es la oficial. mainEntityOfPage resuelve qué entidad es el sujeto principal del contenido. Operan en planos distintos: el canonical evita contenido duplicado, la entidad principal le dice a la IA de qué trata el documento.
¿Qué pasa si no declaro mainEntityOfPage?
El validador no te lo marca como error, porque es una propiedad opcional. Pero dejas que el motor adivine el sujeto de la página a partir del texto. En un sitio con varias páginas similares, esa ambigüedad es justo lo que hace que la IA no sepa a quién citar.
¿mainEntityOfPage va en todas las páginas o solo en las de servicio?
En todas. Cada página tiene un protagonista: un artículo, un servicio, un producto, una persona. Lo que cambia es el tipo de entidad apuntada. En una entrada es el Article, en una página de servicio es el Service, en un producto de WooCommerce es el Product.
¿Puedo declarar la entidad principal sin tener una entrada propia en Wikidata?
Sí. No necesitas que tu empresa tenga una entrada propia en Wikidata para declarar mainEntityOfPage. Puedes apuntar a un nodo interno de tu grafo anclado a entidades verificables mediante sameAs. Lo importante es que la entidad esté desambiguada y referenciada de forma estable.
¿mainEntityOfPage garantiza que la IA me cite?
No, y ningún marcado puede garantizarlo. Los motores generativos no confirman oficialmente qué señales consumen ni cómo ponderan cada una. mainEntityOfPage es la implementación técnica más rigurosa de un factor que estos motores demuestran consumir: la resolución de entidades. Es rigor, no magia.
Conclusión
mainEntityOfPage es una de esas propiedades pequeñas que separan a un sitio “con schema” de un sitio que la IA puede resolver. Sin ella, tu página es un documento suelto; con ella, es una página que habla de una entidad verificable. En un mundo donde los motores generativos resuelven entidades y no keywords, declarar el protagonista de cada página es el primer paso para que te entiendan, te verifiquen y te consideren una fuente.
Convierte cada página en una entidad que la IA resuelve
SemanticGEO cose tu grafo de conocimiento sobre Yoast SEO y emite mainEntityOfPage, sameAs y Q-IDs verificados en cada página, sin que escribas JSON-LD a mano.
Ver planes y precios








