wp_create_post: crear una entrada
Crea una entrada o un tipo de entrada personalizado público. La escritura más suave del servidor: añade un registro y no toca nada existente.
Argumentos
| Argumento | Predeterminado | Significado |
|---|---|---|
post_type |
post |
Cualquier tipo de entrada público |
title |
— | El título |
content |
— | El cuerpo |
excerpt |
— | El extracto |
slug |
— | El slug; se deriva del título cuando se omite |
status |
draft |
El estado de la entrada |
dry_run |
— | Informar sin crear |
Permisos
Allow content writes debe estar abierto.
Capacidad edit_posts, o edit_pages al crear una página. Ámbitos mcp:read, mcp:write, wp:content:read, wp:content:write.
Crea un borrador salvo que se indique lo contrario
Omitir status produce un borrador. Es deliberado: un asistente no puede publicar algo por olvidar decir en qué estado debería estar.
Publicar es, por tanto, siempre un acto explícito, ya sea pasando status en la creación o mediante un wp_update_post posterior. Convertirlo en un paso aparte es el patrón más seguro: pone a una persona entre «el contenido existe» y «el contenido es público».
Usa la simulación
dry_run devuelve would_create con la carga útil que enviaría la herramienta, sin crear nada.
Resulta más útil para confirmar que el tipo de entrada y el estado son los que pretendías antes de un lote:
Usa una simulación para la primera y muéstrame la carga útil.
Qué devuelve
La entrada creada en la forma estándar, incluidos content y el nuevo id.
Conserva el ID. Cada paso posterior —términos, imagen destacada, campos SEO, publicación— hace referencia a él.
Qué no establece
Crear una entrada establece los campos anteriores y nada más. No:
- categorías ni etiquetas — consulta Taxonomy tools;
- la imagen destacada — consulta Media tools;
- los metadatos de la entrada — consulta Comment and meta tools;
- los campos SEO, que son metadatos aparte.
Una entrada creada y revisada sigue sin tener nada de esto a menos que los añadas como pasos propios.
El contenido se almacena tal como se entrega
El argumento content se almacena sin la depuración aplicada a títulos y slugs, de modo que los shortcodes del maquetador sobreviven intactos.
Eso también significa que el marcado no válido del maquetador se almacena con la misma facilidad que el marcado válido. Valida primero —consulta pom_validate_builder_content.
Cómo usarlo bien
Crea una entrada en borrador titulada «Lista de comprobación de mantenimiento de primavera» con este contenido: … Déjala como borrador y dame el ID.
Para varias:
Crea las dos primeras como borradores, muéstrame los IDs y detente.
Las escrituras están limitadas a 20 por minuto, así que un lote grande se reparte de todos modos.
Problemas habituales
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | La compuerta de escritura de contenido está cerrada |
pom_ai_mcp_post_type_denied |
El tipo de entrada no es público |
pom_ai_mcp_forbidden |
No hay edit_posts, o edit_pages para una página |
| Se publicó inmediatamente | status se pasó como publish |
| El slug no es el que querías | Se deriva del título; pasa slug |
| El diseño está roto | El contenido del maquetador no se validó primero |