O que faz
name encontra fotografias pelo nome do ficheiro, como as pessoas lhes chamam («DSC04851»): sem distinguir maiúsculas, corresponde a parte do nome e aceita vários nomes separados por vírgulas de uma só vez. Usa-o para converter os nomes que o utilizador menciona nos ids de fotografia que todas as outras ferramentas esperam. taken é a altura em que a fotografia foi tirada (hora ISO do EXIF): a forma de agrupar uma sessão por dia ou por serão («as fotografias do pôr do sol») quando não há descrição. taken_after / taken_before filtram por ela (ISO, inclusivo; uma data simples cobre o dia inteiro), por exemplo status="keep", taken_after="2026-09-22T18:00": numa sessão grande, filtra em vez de listar tudo. As horas de captura são lidas por analyze_photos, por isso executa-o antes de filtrar por hora; até lá, a nota da resposta indica quantas fotografias ainda não têm hora. Filtra por estado (pending, keep, trash, culled, exported, error) ou omite-o para tudo. Usa limit e offset para percorrer bibliotecas grandes; a resposta inclui a contagem total de correspondências. Os ids de fotografia desta lista são o que todas as ferramentas por fotografia esperam.
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 pedi-la
Não a chamas pelo nome. Dizes o que queres e o agente escolhe a ferramenta:
Seleciona a sessão de casamento em D:/Shoots/eva_tom, mantém os melhores fotogramas e diz-me o que descartaste.
As restantes ferramentas de biblioteca
Fluxos de trabalho que a usam
- Seleciona uma sessão de casamento com IA — Seleção de fotografias de casamento com IA
- Escolhe e exporta uma galeria para o cliente — IA escolher melhores fotografias galeria de cliente
- Encontra fotografias duplicadas e quase duplicadas — encontrar fotografias duplicadas automaticamente
- Pontua e ordena fotografias automaticamente — pontuação automática da qualidade das fotografias
Onde corre
No teu computador. O servidor MCP do imagic é um processo local que o teu cliente de IA inicia; as fotografias nunca saem do teu disco e nada é carregado. Isto é verdade para todas as ferramentas da referência, incluindo esta.
Para a chamares, precisas de um cliente MCP ligado ao imagic. A configuração demora cerca de três minutos para o Claude Code, o Cursor, o VS Code, o Codex, o Gemini CLI e mais dez.
Dá à tua IA o fluxo completo
list_photos é uma de 30 ferramentas do imagic Max. A avaliação gratuita de 500 exportações inclui todas.