O que faz
name encontra fotos pelo nome do arquivo, do jeito que as pessoas se referem a elas ("DSC04851"): sem diferenciar maiúsculas de minúsculas, corresponde a parte do nome e aceita vários nomes separados por vírgula de uma vez. Use para transformar os nomes que o usuário menciona nos ids de foto que todas as outras ferramentas esperam. taken é o momento em que a foto foi feita (horário ISO do EXIF): a forma de agrupar um ensaio por dia ou por noite ("os quadros do pôr do sol") quando não há descrição. taken_after / taken_before filtram por ele (ISO, inclusivo; uma data sozinha cobre o dia inteiro), por exemplo status="keep", taken_after="2026-09-22T18:00": em um ensaio grande, filtre em vez de listar tudo. Os horários de captura são lidos por analyze_photos, então execute-o antes de filtrar por horário; até lá, a note da resposta informa quantas fotos ainda não têm horário. Filtre por status (pending, keep, trash, culled, exported, error) ou omita para ver tudo. Use limit e offset para paginar bibliotecas grandes; a resposta inclui o total de correspondências. Os ids de foto desta lista são o que toda ferramenta por foto espera.
Parâmetros
| Nome | Tipo | Obrigatório |
|---|---|---|
status |
str | None |
opcional |
limit |
int |
opcional |
offset |
int |
opcional |
taken_after |
str | None |
opcional |
taken_before |
str | None |
opcional |
name |
str | None |
opcional |
Como pedir
Você não a chama pelo nome. Você diz o que quer, e o agente escolhe a ferramenta:
Faça a triagem da sessão de casamento em D:/Shoots/eva_tom, mantenha os melhores quadros e me diga o que você descartou.
As outras ferramentas de biblioteca
Fluxos de trabalho que a usam
- Faça a triagem de uma sessão de casamento com IA — triagem de fotos de casamento com IA
- Escolha e exporte uma galeria para o cliente — IA para selecionar as melhores fotos da galeria do cliente
- Encontre fotos duplicadas e quase duplicadas — encontrar fotos duplicadas automaticamente
- Avalie e classifique fotos automaticamente — avaliação automática da qualidade das fotos
Onde roda
Na sua máquina. O servidor MCP do imagic é um processo local que o seu cliente de IA inicia; as fotos nunca saem do seu disco e nada é enviado. Isso vale para todas as ferramentas da referência, inclusive esta.
Para chamá-la, você precisa de um cliente MCP conectado ao imagic. A configuração leva cerca de três minutos para Claude Code, Cursor, VS Code, Codex, Gemini CLI e outros dez.
Dê à sua IA o pipeline inteiro
list_photos é uma das 30 ferramentas do imagic Max. O teste grátis de 500 exportações inclui todas elas.