biblioteca

list_photos

Lista las fotos con id, nombre de archivo, ruta, estado, puntuación, descripción y hora de captura.

Qué hace

name busca fotos por nombre de archivo, como las nombra la gente («DSC04851»): sin distinguir mayúsculas, coincide con parte del nombre y admite varios nombres separados por comas a la vez. Úsala para convertir los nombres que menciona un usuario en los id de foto que esperan todas las demás herramientas. taken es el momento en que se hizo la foto (hora ISO del EXIF): la forma de agrupar una sesión por día o por tarde («los fotogramas del atardecer») cuando no hay descripción. taken_after / taken_before filtran por él (ISO, inclusivo; una fecha sola abarca todo el día), por ejemplo status="keep", taken_after="2026-09-22T18:00": en una sesión grande, filtra en lugar de listarlo todo. Filtra por estado (pending, keep, trash, culled, exported, error) u omítelo para obtenerlo todo. Usa limit y offset para recorrer bibliotecas grandes por páginas; la respuesta incluye el total de coincidencias. Los id de foto de esta lista son los que esperan todas las herramientas por foto.

Parámetros

NombreTipoObligatorio
status str | None opcional
limit int opcional
offset int opcional
taken_after str | None opcional
taken_before str | None opcional
name str | None 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

scan_directory get_library_stats 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

list_photos es una de las 25 herramientas de imagic Max. La prueba gratuita de 500 exportaciones las incluye todas.