Todas as ferramentas

finder_search

Ficheiros e Finder · macOS

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Procura arquivos por nome em qualquer lugar deste Mac (usa mdfind/Spotlight); passe path= para definir o escopo para uma pasta. Os locais de credenciais e identidade são recusados.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglêsmacOS
{
  "properties": {
    "limit": {
      "description": "Max results (default 50)",
      "type": "integer"
    },
    "path": {
      "description": "Limit search to this directory (optional)",
      "type": "string"
    },
    "query": {
      "description": "Filename or content to search for",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para finder_search. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "query": "launch checklist"
}