wp_count_media: cuenta los elementos multimedia
Devuelve cuántos archivos adjuntos existen, desglosados por tipo MIME. Una sola llamada, sin argumentos.
Argumentos
Ninguno.
Permisos
mcp:read y wp:content:read, con upload_files. Solo lectura, sin compuerta de escritura.
Qué devuelve
Un objeto counts indexado por tipo MIME — image/jpeg, image/png, application/pdf y así sucesivamente — con el número de archivos adjuntos de cada tipo.
Qué te dice el desglose
Más de lo que diría un total. La distribución por tipos es una descripción rápida de lo que contiene realmente la biblioteca:
- Sobre todo JPEG y PNG — un sitio de contenido normal.
- Un número elevado de PDF — una biblioteca de documentos, y esos son archivos adjuntos que MCP puede leer y eliminar pero nunca crear.
- Presencia de vídeo o audio — igualmente fuera de lo que aceptan las herramientas de subida.
- Presencia de WebP o AVIF — alguien ha estado convirtiendo, o un plugin de optimización los está generando.
Ese último punto conviene notarlo antes de una operación masiva: una biblioteca donde un plugin de optimización crea formatos modernos junto a los originales tiene más registros de archivos adjuntos que imágenes.
Dimensionar un trabajo de metadatos
El motivo más común para llamarla. Antes de aceptar «añadir texto alternativo a las imágenes»:
Cuenta los elementos multimedia, luego lista los primeros veinte y dime cuántos no tienen texto alternativo.
El recuento establece la escala; la muestra te dice la proporción que necesita trabajo. Juntas convierten una petición abierta en un número.
Para una biblioteca grande, la conclusión honesta suele ser que un repaso exhaustivo no merece la pena, y que el alcance correcto son las imágenes de las páginas que importan. Consulta Genera metadatos de imagen en bloque.
Cuenta lo que MCP no puede crear
Los recuentos incluyen todos los tipos de archivos adjuntos de la biblioteca, no solo las imágenes rasterizadas que aceptan las herramientas de subida.
Así que un total aquí puede superar lo que MCP jamás habría podido producir, y que un tipo aparezca en los recuentos no significa que un asistente pueda añadir más de ese tipo. Consulta wp_upload_media para saber qué se acepta.
Cómo usarla bien
Cuenta los elementos multimedia y muéstrame el desglose por tipo.
¿Cuántas imágenes hay en la biblioteca?
Al empezar con un sitio que no conoces:
Cuenta las entradas, las páginas y los elementos multimedia, y luego detente.
Tres llamadas de lectura, y conoces la forma del contenido del sitio antes de aceptar nada.
Qué no hace
- Sin filtrado. Lo cuenta todo.
- Sin tamaño total en bytes. No se informa del uso del disco.
- Sin recuento de archivos adjuntos no utilizados. Nada aquí identifica huérfanos.
- Sin IDs. Usa
wp_get_media.
La pregunta de los archivos adjuntos no utilizados surge a menudo y esta herramienta no puede responderla. Tampoco puede ninguna otra herramienta de MCP: establecer que un archivo adjunto no tiene referencias implica comprobar el contenido de las entradas, los metadatos, los ajustes del tema y los datos de los maquetadores, lo cual es tarea de un plugin dedicado.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_forbidden |
El usuario que actúa carece de upload_files |
| Recuentos más altos de lo esperado | Variantes de formato generadas almacenadas como archivos adjuntos separados |
| Tipos que no puedes subir | Correcto; se añadieron de otra forma |