wp_get_post: obtener una entrada
Lee una única entrada por su ID, incluido su contenido. Esta es la llamada que debe preceder a toda escritura de contenido.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
id |
Sí | El ID de la entrada |
Permisos
mcp:read y wp:content:read.
Leer una entrada publicada no requiere ninguna capacidad adicional. Leer un borrador, una entrada pendiente o privada requiere edit_post sobre ese elemento concreto.
Qué devuelve
id, post_type, title, slug, status, date, modified, link, excerpt — y content, que los listados omiten.
Por qué importa más de lo que parece
Esta es la herramienta que hace segura una escritura. Un asistente que ha leído la entrada conoce su título real, su estado actual, su contenido actual y su enlace permanente; uno que no lo ha hecho está trabajando a partir de tu descripción de ella.
Dos cosas concretas que conviene confirmar antes de cualquier escritura:
La identidad. Pide que te devuelva el título. Los ID son fáciles de transponer, y una escritura bien formada sobre la entrada equivocada es la forma más común de dañar el contenido.
El estado. Editar un elemento publicado tiene un efecto público inmediato. Editar un borrador no lo tiene.
Lee la entrada 412 y muéstrame el título y el estado; después, espera.
content es el valor almacenado
El campo content es lo que WordPress ha almacenado, antes del renderizado. Para una página del constructor de POM, se trata de la estructura de shortcodes en bruto, no del texto visible.
Esa es la forma correcta para editar, y significa que un asistente que lee una página del constructor ve el diseño que debe conservar. Consulta Crear contenido del constructor de POM.
Restricción por tipo de entrada
Solo se pueden leer los tipos de entrada públicos. Una entrada que pertenezca a un tipo no público devuelve pom_ai_mcp_post_not_found, el mismo error que un ID inexistente — de modo que ese error significa «no alcanzable», no necesariamente «no existe».
Léela de nuevo después de escribir
Las herramientas de escritura devuelven el registro actualizado, pero leer de forma independiente después detecta lo que una respuesta de escritura no puede: valores alterados por un filtro al guardar, un slug regenerado a partir de un título cambiado u otro plugin que actúe sobre la actualización.
Aplica el cambio; después, vuelve a leer la entrada 412 y muéstrame qué es diferente.
Usarla bien
Lee la página 88 y muéstrame su contenido.
Lee la entrada 412 y dime si está publicada.
Muéstrame el extracto actual de la entrada 412 antes de que lo cambies.
Ese último patrón — pedir el valor actual del campo que está a punto de cambiar — es lo que te da un deshacer. Consulta Recuperarse de una escritura fallida.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_post_not_found |
ID incorrecto o un tipo de entrada no público |
pom_ai_mcp_forbidden |
Leer contenido no publicado sin edit_post |
| El contenido parece shortcodes | Correcto; es contenido del constructor |
| El contenido difiere de la página | El valor almacenado es previo al renderizado |