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 é a hora em que a foto foi feita (hora ISO do EXIF): o jeito de agrupar uma sessão por dia ou por noite (“as fotos do pôr do sol”) quando não há descrição. taken_after / taken_before filtram por ela (ISO, inclusivo; uma data sozinha cobre o dia inteiro), por exemplo status="keep", taken_after="2026-09-22T18:00": em uma sessão grande, filtre em vez de listar tudo. Filtre por status (pending, keep, trash, culled, exported, error) ou omita para obter tudo. Use limit e offset para paginar bibliotecas grandes; a resposta inclui a contagem 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 25 ferramentas do imagic Max. O teste grátis de 500 exportações inclui todas elas.