wp_delete_post: eliminar una entrada

Envía una entrada a la papelera o la elimina de forma permanente. La única herramienta de este capítulo marcada como destructiva.

Argumentos

Argumento Obligatorio Significado
id Sí La entrada que se va a eliminar
force No Eliminar de forma permanente en lugar de enviar a la papelera
dry_run No Informar sin eliminar

Permisos

Allow content writes abierto, y delete_post sobre ese elemento concreto — una capacidad distinta de edit_post, de modo que un usuario que puede editar una entrada no necesariamente puede eliminarla.

Ámbitos: mcp:read, mcp:write, wp:content:read, wp:content:write.

Papelera frente a eliminación forzada

Sin force, la entrada va a la papelera de WordPress. Desaparece del sitio y sigue siendo recuperable desde Posts → Trash hasta que se vacíe la papelera.

Con force, se elimina de forma permanente. No hay papelera, no hay revisión y no hay recuperación salvo una copia de seguridad de la base de datos.

La diferencia es toda la historia de seguridad de esta herramienta. Utiliza por defecto la papelera y trata force como una operación que necesita un motivo.

Envía a la papelera la entrada 412. No uses la eliminación forzada.

Haz siempre primero una simulación

dry_run devuelve would_delete con el registro, lo que confirma que estás a punto de eliminar lo que crees que estás eliminando.

Haz una simulación y muéstrame la entrada que eliminarías.

En una eliminación, esa confirmación merece la llamada adicional siempre. Una eliminación bien formada del ID equivocado es indistinguible de una correcta hasta que alguien se da cuenta de que falta la página.

Qué devuelve

deleted y el id. No el registro — léelo antes de eliminar si quieres que quede registrado.

Antes de eliminar nada

  • Confirma la identidad. Lee la entrada y comprueba el título.
  • Comprueba qué enlaza a ella. Una página eliminada deja enlaces internos rotos y elementos de menú muertos.
  • Comprueba si está en un menú. Consulta Site and menu tools.
  • Considera si basta con dejar de publicarla. Poner una entrada en borrador la retira del sitio y conserva todo.

Ese último punto es el que merece la pena usar. «Quita esto del sitio» casi siempre se satisface con un cambio de estado en lugar de una eliminación.

Eliminar varias

No delegues nunca un criterio de eliminación. Nombra los ID:

Envía a la papelera las entradas 412, 415 y 418. Nada más.

No:

Envía a la papelera las entradas antiguas.

Lo segundo delega un juicio sobre tu contenido que el asistente no puede hacer, y el resultado no es reversible sin una copia de seguridad si se usó force.

Después de eliminar

  • Comprueba el sitio en busca de enlaces rotos hacia el elemento eliminado.
  • Comprueba los menús.
  • Purga la caché — todavía puede servirse una copia en caché de una página eliminada.

Problemas comunes

Síntoma Causa
Se rechaza la escritura Puerta de escritura de contenido cerrada
pom_ai_mcp_post_not_found ID incorrecto
pom_ai_mcp_forbidden Sin delete_post sobre ese elemento
La entrada ha desaparecido de forma permanente Se pasó force
Aparecieron enlaces rotos Otro contenido del sitio hacía referencia a ella
La página aún se carga Está en caché
`wp_update_post`: actualizar una entrada
Anterior
`wp_create_page`: crear una página
Siguiente