biblioteca

list_photos

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

Qué hace

name encuentra fotos por nombre de archivo, tal como la gente se refiere a ellas ("DSC04851"): sin distinguir mayúsculas, coincide con parte del nombre y acepta varios nombres separados por comas a la vez. Úsalo para convertir los nombres que menciona un usuario en los ids 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 ("the sunset frames") cuando no hay descripción. taken_after / taken_before filtran por ella (ISO, inclusivo; una fecha sola cubre el día entero), por ejemplo status="keep", taken_after="2026-09-22T18:00": en una sesión grande, filtra en lugar de listarlo todo. Las horas de captura las lee analyze_photos, así que ejecútalo antes de filtrar por hora; hasta entonces, la nota de la respuesta indica cuántas fotos aún no tienen hora. Filtra por status (pending, keep, trash, culled, exported, error) u omítelo para obtener todo. Usa limit y offset para recorrer bibliotecas grandes por páginas; la respuesta incluye el total de coincidencias. Los ids 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 30 herramientas de imagic Max. La prueba gratuita de 500 exportaciones las incluye todas.