Referencia de herramientas de medios de WordPress
Ocho herramientas para la biblioteca de medios. Son el grupo más restringido del servidor: las subidas solo aceptan imágenes rasterizadas y la descarga remota está delimitada de varias formas a la vez.
Las herramientas
| Herramienta | Hace | Escribe |
|---|---|---|
wp_get_media |
Lista los adjuntos | |
wp_get_media_item |
Lee un adjunto | |
wp_count_media |
Cuenta los adjuntos por tipo | |
wp_upload_media |
Sube desde una carga base64 | Sí |
wp_upload_media_from_url |
Descarga una URL pública y la sube | Sí |
wp_update_media |
Cambia el título, la leyenda, la descripción o el texto alternativo | Sí |
wp_set_featured_image |
Asigna o elimina una imagen destacada | Sí |
wp_delete_media |
Elimina un adjunto | Sí |
Permisos
Leer cualquier cosa requiere la capacidad upload_files, incluidos los listados y los recuentos. A diferencia de las entradas, no hay lectura sin autenticación de los medios publicados a través de estas herramientas.
Las escrituras necesitan además Allow content writes abierto, más:
| Herramienta | Capacidad |
|---|---|
| Subidas | upload_files |
| Actualizar | edit_post sobre el adjunto |
| Definir imagen destacada | edit_post sobre la entrada objetivo, no sobre el adjunto |
| Eliminar | delete_post sobre el adjunto |
Ámbitos en todo el documento: mcp:read y wp:content:read, más mcp:write y wp:content:write para las escrituras.
Solo imágenes, verificadas dos veces
Las subidas aceptan JPEG, PNG, GIF, WebP y AVIF y nada más. Nada de PDF, ni vídeo, ni audio, ni SVG, ni archivos comprimidos.
La comprobación se ejecuta dos veces: una sobre la extensión del nombre de archivo y otra sobre el contenido real del archivo después de escribirlo en el disco. Un archivo cuyo nombre dice .png y cuyos bytes dicen otra cosa se rechaza en la segunda comprobación.
Los dos errores se pueden distinguir: pom_ai_mcp_media_extension_denied para el nombre y pom_ai_mcp_media_mime_denied para el contenido.
El límite de 10 MB
Ambas herramientas de subida están limitadas a 10 MB, y la herramienta de URL también limita la respuesta de descarga al mismo tamaño.
La forma de la respuesta
Cada herramienta que devuelve un adjunto devuelve los mismos campos: id, title, url, mime_type, alt, caption, description y date.
Observa lo que falta: ni dimensiones, ni tamaño de archivo, ni lista de tamaños generados. Para comprobar si una imagen es lo bastante grande para un hueco de héroe, tienes que mirarla, no mirar la respuesta.
Simulaciones
Las cinco herramientas de escritura admiten dry_run, y cada una informa de algo distinto:
| Herramienta | Informa |
|---|---|
| Subir desde URL | La URL que descargaría |
| Subir | El nombre de archivo saneado y el recuento de bytes decodificado |
| Actualizar | Los cambios que aplicaría |
| Definir imagen destacada | La entrada y el ID de la miniatura |
| Eliminar | El ID que eliminaría |
La simulación de subida es la útil: decodifica la carga e informa del tamaño real sin escribir nada, lo que detecta una cadena base64 truncada antes de que se convierta en una subida fallida.
La que no es recuperable
Eliminar un adjunto no se deshace con la papelera de WordPress de la misma forma que una entrada. Lee wp_delete_media antes de usarlo.
Relacionado
- Subir y asignar una imagen destacada
- Escribir texto alternativo que ayude
- Herramientas de imagen para la generación de imágenes propia de POM AI, que es independiente de MCP