bibliotek

list_photos

Lista bilder med id, filnamn, sökväg, status, poäng, beskrivning och tidpunkt för tagningen.

Vad det gör

name hittar bilder via filnamn, så som människor hänvisar till dem (”DSC04851”): skiftlägesokänsligt, matchar en del av namnet och tar flera kommaseparerade namn på en gång. Använd det för att göra om de namn som en användare nämner till de bild-id som alla andra verktyg förväntar sig. taken är när bilden togs (ISO-tid från EXIF): sättet att gruppera en fotografering efter dag eller kväll (”solnedgångsbilderna”) när det inte finns någon beskrivning. taken_after / taken_before filtrerar på den (ISO, inklusive, ett enbart datum täcker hela dagen), till exempel status="keep", taken_after="2026-09-22T18:00": filtrera på en stor fotografering i stället för att lista allt. Tagningstider läses av analyze_photos, så kör det före filtrering på tid. Tills dess anger svarets anteckning hur många bilder som ännu saknar tid. Filtrera på status (pending, keep, trash, culled, exported, error) eller utelämna den för allt. Använd limit och offset för att bläddra i stora bibliotek. Svaret innehåller det totala antalet träffar. Bild-id från den här listan är vad varje verktyg per bild förväntar sig.

Parametrar

NamnTypObligatorisk
status str | None valfritt
limit int valfritt
offset int valfritt
taken_after str | None valfritt
taken_before str | None valfritt
name str | None valfritt

Så ber du om det

Du anropar det inte vid namn. Du säger vad du vill ha, och agenten väljer verktyget:

Gallra bröllopsfotograferingen i D:/Shoots/eva_tom, behåll de bästa bilderna och berätta vad du sorterade bort.

Resten av verktygen i gruppen bibliotek

scan_directory get_library_stats get_photo get_preview_url get_job_status

Arbetsflöden som använder det

Var det körs

På din dator. imagics MCP-server är en lokal process som din AI-klient startar; bilderna lämnar aldrig din disk och inget laddas upp. Det gäller för varje verktyg i referensen, även det här.

För att anropa det behöver du en MCP-klient ansluten till imagic. Installationen tar ungefär tre minuter för Claude Code, Cursor, VS Code, Codex, Gemini CLI och tio till.

Ge din AI hela pipelinen

list_photos är ett av 30 verktyg i imagic Max. Den gratis provperioden på 500 exporter innehåller alla.