biblioteca

list_photos

Llista fotos amb id, nom de fitxer, ruta, estat, puntuació, descripció i hora de captura.

Què fa

name troba fotos pel nom de fitxer, com hi fa referència la gent ("DSC04851"): no distingeix majúscules, coincideix amb una part del nom i accepta diversos noms separats per comes alhora. Usa'l per convertir els noms que menciona un usuari en els ids de foto que esperen totes les altres eines. taken és el moment en què es va fer la foto (hora ISO de l'EXIF): la manera d'agrupar una sessió per dia o per vespre («els fotogrames de la posta de sol») quan no hi ha descripció. taken_after / taken_before filtren per aquest valor (ISO, inclusiu; una data sola cobreix tot el dia), per exemple status="keep", taken_after="2026-09-22T18:00": en una sessió gran, filtra en lloc de llistar-ho tot. Les hores de captura les llegeix analyze_photos, així que executa-la abans de filtrar per hora; fins llavors la nota de la resposta indica quantes fotos encara no tenen hora. Filtra per estat (pending, keep, trash, culled, exported, error) o omet-lo per veure-ho tot. Usa limit i offset per paginar biblioteques grans; la resposta inclou el recompte total de coincidències. Els ids de foto d'aquesta llista són els que espera cada eina per foto.

Paràmetres

NomTipusObligatori
status str | None opcional
limit int opcional
offset int opcional
taken_after str | None opcional
taken_before str | None opcional
name str | None opcional

Com demanar-la

No la crides pel nom. Dius què vols, i l'agent tria l'eina:

Selecciona la sessió de casament de D:/Shoots/eva_tom, queda't amb els millors fotogrames i digues-me què has descartat.

La resta de les eines de biblioteca

scan_directory get_library_stats get_photo get_preview_url get_job_status

Fluxos de treball que la fan servir

On s'executa

Al teu ordinador. El servidor MCP d'imagic és un procés local que inicia el teu client d'IA; les fotos no surten mai del teu disc i no es puja res. Això és cert per a totes les eines de la referència, aquesta inclosa.

Per cridar-la necessites un client MCP connectat a imagic. La configuració porta uns tres minuts per a Claude Code, Cursor, VS Code, Codex, Gemini CLI i deu més.

Dona a la teva IA tot el procés

list_photos és una de les 30 eines d'imagic Max. La prova gratuïta de 500 exportacions les inclou totes.