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, nel modo in cui le persone le citano ("DSC04851"): senza distinzione tra maiuscole e minuscole, corrisponde a una parte del nome e accetta più nomi separati da virgole. Usalo per trasformare i nomi citati da un utente negli id foto che ogni altro strumento si aspetta. taken è il momento in cui è stata scattata la foto (ora ISO dall'EXIF): serve a raggruppare un servizio per giorno o per sera ("the sunset frames" cioè i fotogrammi del tramonto) quando non c'è una descrizione. taken_after / taken_before filtrano in base a esso (ISO, estremi inclusi; una data semplice copre l'intera giornata), per esempio status="keep", taken_after="2026-09-22T18:00": su un servizio grande, filtra invece di elencare tutto. Gli orari di scatto vengono letti da analyze_photos, quindi eseguilo prima di filtrare per orario; finché non lo fai, la nota nella risposta indica quante foto non hanno ancora un orario. Filtra per status (pending, keep, trash, culled, exported, error) oppure omettilo per ottenere 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 30 strumenti di imagic Max. La prova gratuita da 500 esportazioni li include tutti.