Bibliothek

list_photos

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

Was es tut

name findet Fotos anhand des Dateinamens, so wie Menschen sie nennen ("DSC04851"): ohne Beachtung der Groß- und Kleinschreibung, mit Teiltreffern im Namen, und mehrere durch Kommas getrennte Namen auf einmal sind möglich. Damit übersetzen Sie die vom Benutzer genannten Namen in die Foto-IDs, die alle anderen Tools erwarten. taken ist der Aufnahmezeitpunkt des Fotos (ISO-Zeit aus den EXIF-Daten): So lässt sich eine Aufnahmeserie nach Tag oder Abend gruppieren ("the sunset frames"), wenn keine Beschreibung vorhanden ist. taken_after / taken_before filtern danach (ISO, inklusive; ein reines Datum umfasst den ganzen Tag), zum Beispiel status="keep", taken_after="2026-09-22T18:00": Filtern Sie bei einem großen Shooting, statt alles aufzulisten. Aufnahmezeiten werden von analyze_photos gelesen, führen Sie es also vor dem Filtern nach Zeit aus; bis dahin nennt der Hinweis in der Antwort, wie viele Fotos noch keine Zeit haben. Filtern Sie nach status (pending, keep, trash, culled, exported, error) oder lassen Sie ihn weg, um alles zu erhalten. Nutzen Sie limit und offset, um große Bibliotheken seitenweise zu durchlaufen; die Antwort enthält die Gesamtzahl der Treffer. Die Foto-IDs aus dieser Liste erwarten alle Tools, die sich auf einzelne Fotos beziehen.

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 30 Tools in imagic Max. Die kostenlose Testphase mit 500 Exporten enthält alle.