Qué hace
name encuentra fotos por nombre de archivo, como se refiere la gente 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 tomó 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 cubre 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. 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 estado (pending, keep, trash, culled, exported, error) u omítelo para obtener todo. Usa limit y offset para paginar bibliotecas grandes; 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
| Nombre | Tipo | Obligatorio |
|---|---|---|
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 pedirlo
No la llamas por su nombre. Dices lo que quieres y el agente elige la herramienta:
Selecciona la sesión de boda en D:/Shoots/eva_tom, quédate con los mejores fotogramas y dime qué descartaste.
El resto de las herramientas de biblioteca
Flujos de trabajo que la usan
- Selecciona una sesión de boda con IA — Selección de fotos de boda con IA
- Elige y exporta una galería para el cliente — IA para elegir las mejores fotos de una galería de cliente
- Encuentra fotos duplicadas y casi duplicadas — encontrar fotos duplicadas automáticamente
- Puntúa y ordena fotos automáticamente — puntuación automática de la calidad de las fotos
Dónde se ejecuta
En tu máquina. El servidor MCP de imagic es un proceso local que inicia tu cliente de IA; las fotos nunca salen de tu disco y no se sube nada. Esto se cumple en todas las herramientas de la referencia, incluida esta.
Para llamarla necesitas un cliente MCP conectado a imagic. La configuración toma unos tres minutos con Claude Code, Cursor, VS Code, Codex, Gemini CLI y otros diez.
Dale a tu IA todo el flujo de trabajo
list_photos es una de las 30 herramientas de imagic Max. La prueba gratuita de 500 exportaciones las incluye todas.