Bibliothek

list_photos

Listet Fotos mit ID, Dateiname, Pfad, Status, Bewertung, Beschreibung und Aufnahmezeit auf.

Was es tut

name findet Fotos über den Dateinamen, so wie Leute sie nennen („DSC04851“): Groß-/Kleinschreibung egal, passt auf Teile des Namens und nimmt mehrere durch Kommas getrennte Namen auf einmal. Nutzen Sie es, um die Namen, die ein Nutzer nennt, in die Foto-IDs zu übersetzen, die jedes andere Tool erwartet. taken ist der Aufnahmezeitpunkt des Fotos (ISO-Zeit aus EXIF): die Möglichkeit, ein Shooting nach Tag oder Abend zu gruppieren („die Sonnenuntergangsbilder“), wenn es keine Beschreibung gibt. taken_after / taken_before filtern danach (ISO, inklusive; ein reines Datum deckt den ganzen Tag ab), zum Beispiel status="keep", taken_after="2026-09-22T18:00": Filtern Sie bei einem großen Shooting, statt alles aufzulisten. Filtern Sie nach status (pending, keep, trash, culled, exported, error) oder lassen Sie ihn weg für alles. Mit limit und offset blättern Sie durch große Bibliotheken; die Antwort enthält die Gesamtzahl der Treffer. Foto-IDs aus dieser Liste erwartet jedes Tool pro Foto.

Parameter

NameTypPflicht
status str | None optional
limit int optional
offset int optional
taken_after str | None optional
taken_before str | None optional
name str | None optional

So fragen Sie danach

Sie rufen es nicht beim Namen auf. Sie sagen, was Sie wollen, und der Agent wählt das Tool:

Sortiere das Hochzeitsshooting in D:/Shoots/eva_tom aus, behalte die besten Bilder und sag mir, was du verworfen hast.

Weitere Tools der Gruppe „Bibliothek“

scan_directory get_library_stats get_photo get_preview_url get_job_status

Workflows, die es nutzen

Wo es läuft

Auf Ihrem Rechner. Der MCP-Server von imagic ist ein lokaler Prozess, den Ihr KI-Client startet; die Fotos verlassen nie Ihre Festplatte, und nichts wird hochgeladen. Das gilt für jedes Tool der Referenz, auch für dieses.

Um es aufzurufen, brauchen Sie einen mit imagic verbundenen MCP-Client. Die Einrichtung dauert etwa drei Minuten für Claude Code, Cursor, VS Code, Codex, Gemini CLI und zehn weitere.

Geben Sie Ihrer KI die ganze Pipeline

list_photos ist eines von 25 Tools in imagic Max. Die kostenlose Testphase mit 500 Exporten enthält alle.