wp_get_comments: listar comentarios
Enumera comentarios, opcionalmente filtrados por entrada y estado.
Argumentos
| Argumento | Valor predeterminado | Significado |
|---|---|---|
post_id |
— | Restringir a una entrada |
status |
all |
Estado del comentario |
page |
1 | Número de página |
per_page |
20 | Comentarios por página, limitados a 1–100 |
Permisos
mcp:read y wp:content:read, además de la capacidad moderate_comments.
Leer comentarios es un permiso de moderación, no de contenido. Ni siquiera los comentarios aprobados y visibles para cualquier visitante pueden listarse sin él.
Qué devuelve
Solo items — sin total, igual que en los listados de taxonomías. Cada comentario incluye id, post_id, author, content, status y date.
Como no hay total y per_page se limita a 100, un listado no puede indicarte cuántos comentarios existen más allá de la página que has obtenido. En un sitio con una sección de comentarios activa, planifica la paginación.
Los estados
all es el valor predeterminado e incluye comentarios aprobados, pendientes, spam y en papelera juntos — algo que rara vez es lo que quieres.
Filtra deliberadamente:
| Estado | Muestra |
|---|---|
approve |
Comentarios publicados |
hold |
La cola de moderación |
spam |
Marcados como spam |
trash |
En papelera |
Para la cola de moderación específicamente, wp_get_pending_comments es la misma llamada con hold aplicado.
Leer comentarios los transmite
El contenido de los comentarios se envía al cliente conectado, y los comentarios contienen con frecuencia datos personales — nombres, direcciones de correo electrónico en el campo de autor, números de teléfono, referencias de pedidos y, en ocasiones, datos de salud o financieros en un contexto de soporte.
Eso es inherente a moderar mediante MCP, y conviene saberlo antes de orientar a un asistente hacia una sección de comentarios muy activa. Consulta Privacidad de audio para el argumento equivalente sobre la dictación, y Comprende los datos enviados para el procesamiento con IA en general.
Deja que el asistente resuma, no que decida
El patrón útil:
Agrupa estos comentarios en spam evidente, probablemente auténticos y dudosos. No apruebes, elimines ni marques nada.
Resume los comentarios pendientes en una línea cada uno.
Luego actúa tú sobre los ID concretos. Delegar «aprueba los auténticos» significa ceder un juicio editorial sobre mensajes que la gente te ha escrito a ti.
Auditar una entrada concreta
Lista los comentarios de la entrada 412 con sus estados.
Útil cuando una entrada está atrayendo spam, o al comprobar si una discusión necesita atención antes de modificar la propia entrada.
Problemas habituales
| Síntoma | Causa |
|---|---|
pom_ai_mcp_forbidden |
El usuario que actúa carece de moderate_comments |
| Spam y papelera mezclados en los resultados | El estado predeterminado es all |
| Menos comentarios de los esperados | per_page se limita a 100 y no hay total |
| Un resultado vacío en una entrada con comentarios | post_id incorrecto, o todos están en un estado que has filtrado |