biblioteca

scan_directory

Escaneia uma pasta de fotos para dentro da biblioteca do imagic.

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

NomeTipoObrigató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

get_library_stats list_photos get_photo get_preview_url get_job_status

Fluxos de trabalho que a usam

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.