bibliothèque

list_photos

Lister les photos avec id, nom de fichier, chemin, statut, note, description et heure de prise de vue.

Rôle

name recherche les photos par nom de fichier, comme les gens les désignent ("DSC04851") : insensible à la casse, correspond à une partie du nom et accepte plusieurs noms séparés par des virgules. Servez-vous-en pour convertir les noms cités par un utilisateur en identifiants de photo, que tous les autres outils attendent. taken est la date de prise de vue de la photo (heure ISO issue de l'EXIF) : c'est le moyen de regrouper une séance par jour ou par soirée ("the sunset frames", soit les images du coucher de soleil) quand il n'y a pas de description. taken_after / taken_before filtrent selon cette date (ISO, bornes incluses ; une date seule couvre toute la journée), par exemple status="keep", taken_after="2026-09-22T18:00" : sur une grande séance, filtrez plutôt que de tout lister. Les heures de prise de vue sont lues par analyze_photos, lancez-le donc avant de filtrer par heure ; tant que ce n'est pas fait, la note de la réponse indique combien de photos n'ont pas encore d'heure. Filtrez par status (pending, keep, trash, culled, exported, error) ou omettez-le pour tout obtenir. Utilisez limit et offset pour parcourir les grandes bibliothèques ; la réponse inclut le nombre total de correspondances. Les identifiants de photo de cette liste sont ceux qu'attend chaque outil par photo.

Paramètres

NomTypeRequis
status str | None facultatif
limit int facultatif
offset int facultatif
taken_after str | None facultatif
taken_before str | None facultatif
name str | None facultatif

Comment le demander

Vous ne l’appelez pas par son nom. Vous dites ce que vous voulez, et l’agent choisit l’outil :

Trie la séance de mariage de D:/Shoots/eva_tom, garde les meilleures vues et dis-moi ce que tu as écarté.

Les autres outils du groupe bibliothèque

scan_directory get_library_stats get_photo get_preview_url get_job_status

Workflows qui l’utilisent

Où il s’exécute

Sur votre machine. Le serveur MCP d’imagic est un processus local que démarre votre client IA ; les photos ne quittent jamais votre disque et rien n’est envoyé. C’est vrai de chaque outil de la référence, y compris celui-ci.

Pour l’appeler, il vous faut un client MCP connecté à imagic. L’installation prend environ trois minutes pour Claude Code, Cursor, VS Code, Codex, Gemini CLI et dix autres.

Donnez toute la chaîne à votre IA

list_photos est l’un des 30 outils d’imagic Max. L’essai gratuit de 500 exports les inclut tous.