O que faz
Use esta primeiro, antes de qualquer triagem, edição ou exportação: nada mais funciona em fotos que não foram ingeridas. Informe um caminho absoluto para uma pasta com arquivos RAW ou JPEG/PNG/TIFF. As subpastas são incluídas. Escanear de novo é seguro; arquivos já conhecidos são pulados. Passe o caminho exatamente como o usuário o informou, completo e sem alterações. Nomes de pasta costumam conter espaços e “ - ” (por exemplo “Holland 2025 - people-free”); nunca divida nem encurte um caminho em um hífen. Tudo dentro da pasta é importado, então, se a pasta não existir, a ferramenta retorna um erro com as correspondências mais próximas, e, se houver uma pasta de nome parecido ao lado (ou dentro), a ferramenta se recusa e as lista: pergunte ao usuário qual delas ele quer dizer. Defina confirm_exact_path=true somente quando o usuário tiver confirmado que aquela pasta exata é a que ele quer. Retorna as contagens de arquivos descobertos, recém-ingeridos e pulados. Em uma conexão remota, isso pode levar minutos em um cartão grande: passado um orçamento curto, ela retorna {"status": "running", "job_id": ...} em vez disso; chame get_job_status com esse job_id para continuar verificando e obter o mesmo resultado mostrado acima quando ficar pronto. Clientes locais sempre recebem o resultado diretamente.
Parâmetros
| Nome | Tipo | Obrigatório |
|---|---|---|
path |
str |
obrigatório |
confirm_exact_path |
bool |
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
- Encontre fotos duplicadas e quase duplicadas — encontrar fotos duplicadas automaticamente
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
scan_directory é uma das 30 ferramentas do imagic Max. O teste grátis de 500 exportações inclui todas elas.