biblioteca

scan_directory

Escanea una carpeta de fotos y la incorpora a la biblioteca de imagic.

Qué hace

Úsala primero, antes de seleccionar, editar o exportar: nada más funciona con fotos que no se hayan incorporado. Indica una ruta absoluta a una carpeta de archivos RAW o JPEG/PNG/TIFF. Se incluyen las subcarpetas. Volver a escanear es seguro; los archivos ya conocidos se omiten. Pasa la ruta exactamente como la dio el usuario, completa y sin modificar. Los nombres de carpeta suelen contener espacios y « - » (por ejemplo «Holland 2025 - people-free»); nunca dividas ni acortes una ruta en un guion. Se importa todo lo que hay dentro de la carpeta, así que si la carpeta no existe la herramienta devuelve un error con las coincidencias más cercanas, y si hay una carpeta con nombre parecido al lado (o dentro), la herramienta se niega y las enumera: pregunta al usuario cuál quiere decir. Establece confirm_exact_path=true solo cuando el usuario haya confirmado que esa carpeta exacta es la que quiere. Devuelve el recuento de archivos descubiertos, incorporados por primera vez y omitidos. En una conexión remota esto puede tardar minutos con una tarjeta grande: pasado un breve margen devuelve {"status": "running", "job_id": ...} en su lugar; llama a get_job_status con ese job_id para seguir comprobándolo y obtener el mismo resultado descrito arriba cuando esté listo. Los clientes locales siempre reciben el resultado directamente.

Parámetros

NombreTipoObligatorio
path str obligatorio
confirm_exact_path bool opcional

Cómo pedirla

No la llamas por su nombre. Dices lo que quieres y el agente elige la herramienta:

Selecciona la sesión de boda de D:/Shoots/eva_tom, quédate con los mejores fotogramas y dime qué has descartado.

El resto de las herramientas de biblioteca

get_library_stats list_photos get_photo get_preview_url get_job_status

Flujos de trabajo que la usan

Dónde se ejecuta

En tu ordenador. El servidor MCP de imagic es un proceso local que arranca tu cliente de IA; las fotos nunca salen de tu disco y no se sube nada. Eso vale para todas las herramientas de la referencia, incluida esta.

Para llamarla necesitas un cliente MCP conectado a imagic. La configuración lleva unos tres minutos con Claude Code, Cursor, VS Code, Codex, Gemini CLI y otros diez.

Dale a tu IA todo el proceso

scan_directory es una de las 30 herramientas de imagic Max. La prueba gratuita de 500 exportaciones las incluye todas.