wp_get_seo_meta: leer los campos SEO admitidos
Lee el título SEO y la descripción almacenados en una entrada, tanto para Yoast SEO como para Rank Math.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
post_id |
Sí | La entrada o página |
Permisos
mcp:read y wp:content:read, más edit_post sobre esa entrada concreta.
El mismo requisito que para leer el resto de metadatos de la entrada: estos campos son meta de la entrada, almacenados bajo las claves propias del plugin de SEO.
Qué devuelve
El ID de la entrada, más un bloque yoast y un bloque rank_math, cada uno con un title y un description.
Ambos bloques se devuelven independientemente de qué plugin esté instalado. La herramienta lee ambos conjuntos de claves meta de forma incondicional, así que en un sitio que ejecuta Rank Math el bloque de Yoast vuelve vacío, y viceversa.
Por tanto, los valores vacíos en un bloque significan que no hay nada almacenado bajo esas claves, no que algo haya fallado.
La lectura te indica qué plugin está en uso
Ese comportamiento tiene un efecto secundario útil: el bloque que tenga valores es el plugin que realmente gestiona el SEO en este sitio.
Lee el meta SEO de la entrada 412 y dime qué plugin tiene valores.
Establece eso una vez, al inicio de cualquier trabajo de SEO, para que las escrituras posteriores vayan a las claves correctas. Consulta wp_update_seo_meta.
Si ambos están vacíos, o bien la entrada no tiene sobrescrituras de SEO —algo habitual, ya que ambos plugins usan plantillas como alternativa— o bien no hay ningún plugin instalado.
Vacío suele significar «está usando la plantilla»
Tanto Yoast como Rank Math generan un título y una descripción a partir de plantillas de todo el sitio cuando una entrada no tiene sobrescritura. Un campo vacío aquí significa que la entrada está usando esa plantilla, no que no tenga ningún título SEO.
Así que el front end puede mostrar una meta descripción perfectamente buena mientras esta herramienta no informa de nada. Comprueba el código fuente de la página renderizada si necesitas saber qué se está emitiendo realmente.
Esa distinción importa antes de escribir: rellenar una sobrescritura sustituye el resultado de una plantilla que quizá ya sea correcto.
Solo dos campos por plugin
Título y descripción. No la palabra clave de enfoque, no la URL canónica, no las directivas de robots, no los campos Open Graph o Twitter, no los ajustes de schema, ni las plantillas SEO de todo el sitio.
La herramienta cubre los dos campos que más a menudo necesitan editarse en bloque, y nada más. Cualquier cosa adicional es tarea de la propia interfaz del plugin.
Leer antes de una pasada de SEO
El uso realista es encontrar entradas que necesitan atención:
Lee el meta SEO de estos ID de entrada y dime cuáles no tienen descripción.
Combinado con wp_get_posts para obtener los ID, eso produce una lista de trabajo. Cada entrada necesita su propia llamada, así que una auditoría grande son muchas llamadas de lectura —limitadas por el límite de velocidad de lectura y no por el de escritura, lo que la hace viable.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_forbidden |
No hay edit_post sobre esa entrada |
| Ambos bloques vacíos | No hay sobrescrituras almacenadas; el plugin está usando plantillas |
| Un bloque siempre vacío | Ese plugin no es el que está en uso |
| El front end muestra una descripción que la herramienta no muestra | Procede de la plantilla del plugin |
| La entrada tiene ajustes SEO que no se muestran aquí | Solo se cubren el título y la descripción |
Relacionado
wp_update_seo_metawp_get_post_metapara otros metadatos- Acortar texto para escribir descripciones con la longitud adecuada