libreria

list_photos

Elenca le foto con id, nome file, percorso, stato, punteggio, descrizione e ora di scatto.

Cosa fa

name trova le foto per nome file, come le chiamano le persone («DSC04851»): senza distinzione tra maiuscole e minuscole, corrisponde a una parte del nome e accetta più nomi separati da virgola in una volta. Usalo per trasformare i nomi che l'utente cita negli id delle foto che ogni altro strumento si aspetta. taken è il momento in cui la foto è stata scattata (ora ISO dall'EXIF): è il modo di raggruppare uno shooting per giorno o per sera («i fotogrammi del tramonto») quando non c'è una descrizione. taken_after / taken_before filtrano su quel valore (ISO, inclusivo; una data da sola copre l'intera giornata), per esempio status="keep", taken_after="2026-09-22T18:00": su uno shooting grande, filtra invece di elencare tutto. Filtra per stato (pending, keep, trash, culled, exported, error) oppure omettilo per avere tutto. Usa limit e offset per scorrere le librerie grandi; la risposta include il numero totale di corrispondenze. Gli id foto di questo elenco sono quelli che ogni strumento per singola foto si aspetta.

Parametri

NomeTipoObbligatorio
status str | None opzionale
limit int opzionale
offset int opzionale
taken_after str | None opzionale
taken_before str | None opzionale
name str | None opzionale

Come chiederlo

Non lo richiami per nome. Dici cosa vuoi e l'agente sceglie lo strumento:

Seleziona le foto del matrimonio in D:/Shoots/eva_tom, tieni i fotogrammi migliori e dimmi cosa hai scartato.

Gli altri strumenti di libreria

scan_directory get_library_stats get_photo get_preview_url get_job_status

Flussi di lavoro che lo usano

Dove gira

Sul tuo computer. Il server MCP di imagic è un processo locale avviato dal tuo client AI; le foto non lasciano mai il tuo disco e nulla viene caricato. Vale per ogni strumento del riferimento, questo compreso.

Per richiamarlo serve un client MCP collegato a imagic. La configurazione richiede circa tre minuti per Claude Code, Cursor, VS Code, Codex, Gemini CLI e altri dieci.

Dai alla tua AI l'intera pipeline

list_photos è uno dei 25 strumenti di imagic Max. La prova gratuita da 500 esportazioni li include tutti.