βιβλιοθήκη

list_photos

Απαριθμεί φωτογραφίες με id, όνομα αρχείου, διαδρομή, κατάσταση, βαθμολογία, περιγραφή και ώρα λήψης.

Τι κάνει

Το name βρίσκει φωτογραφίες από το όνομα αρχείου, όπως τις αναφέρουν οι άνθρωποι («DSC04851»): χωρίς διάκριση πεζών-κεφαλαίων, ταιριάζει με μέρος του ονόματος και δέχεται πολλά ονόματα χωρισμένα με κόμμα ταυτόχρονα. Χρησιμοποίησέ το για να μετατρέψεις τα ονόματα που αναφέρει ο χρήστης στα id φωτογραφιών που περιμένει κάθε άλλο εργαλείο. Το taken είναι η στιγμή που τραβήχτηκε η φωτογραφία (ώρα ISO από το EXIF): ο τρόπος να ομαδοποιήσεις μια λήψη ανά ημέρα ή ανά βράδυ («τα κάδρα του ηλιοβασιλέματος») όταν δεν υπάρχει περιγραφή. Τα taken_after / taken_before φιλτράρουν με αυτό (ISO, συμπεριλαμβανομένων των ορίων· μια σκέτη ημερομηνία καλύπτει ολόκληρη την ημέρα), για παράδειγμα status="keep", taken_after="2026-09-22T18:00": σε μεγάλη λήψη, φίλτραρε αντί να απαριθμείς τα πάντα. Οι ώρες λήψης διαβάζονται από το analyze_photos, οπότε τρέξε το πριν φιλτράρεις με ώρα· μέχρι τότε η σημείωση της απάντησης λέει πόσες φωτογραφίες δεν έχουν ακόμη ώρα. Φίλτραρε με status (pending, keep, trash, culled, exported, error) ή παράλειψέ το για τα πάντα. Χρησιμοποίησε limit και offset για σελιδοποίηση σε μεγάλες βιβλιοθήκες· η απάντηση περιλαμβάνει τον συνολικό αριθμό ταιριασμάτων. Τα id φωτογραφιών από αυτή τη λίστα είναι αυτά που περιμένει κάθε εργαλείο ανά φωτογραφία.

Παράμετροι

ΌνομαΤύποςΑπαιτείται
status str | None προαιρετικό
limit int προαιρετικό
offset int προαιρετικό
taken_after str | None προαιρετικό
taken_before str | None προαιρετικό
name str | None προαιρετικό

Πώς το ζητάς

Δεν το καλείς με το όνομά του. Λες τι θέλεις, και ο πράκτορας διαλέγει το εργαλείο:

Επίλεξε τις φωτογραφίες του γάμου στο D:/Shoots/eva_tom, κράτα τα καλύτερα κάδρα και πες μου τι άφησες έξω.

Τα υπόλοιπα εργαλεία της ομάδας βιβλιοθήκη

scan_directory get_library_stats get_photo get_preview_url get_job_status

Workflows που το χρησιμοποιούν

Πού τρέχει

Στον υπολογιστή σου. Ο διακομιστής MCP του imagic είναι μια τοπική διεργασία που ξεκινά ο πελάτης AI σου· οι φωτογραφίες δεν φεύγουν ποτέ από τον δίσκο σου και τίποτα δεν ανεβαίνει. Αυτό ισχύει για κάθε εργαλείο της αναφοράς, και για αυτό.

Για να το καλέσεις χρειάζεσαι έναν πελάτη MCP συνδεδεμένο με το imagic. Η ρύθμιση παίρνει περίπου τρία λεπτά για Claude Code, Cursor, VS Code, Codex, Gemini CLI και δέκα ακόμα.

Δώσε στο AI σου ολόκληρη τη ροή

Το list_photos είναι ένα από τα 30 εργαλεία του imagic Max. Η δωρεάν δοκιμή 500 εξαγωγών τα περιλαμβάνει όλα.