proton_search_emails

Proton Mail · macOS · Windows

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

Pesquisa uma pasta de uma conta do Proton Mail por `query` nos cabeçalhos e no texto das mensagens, das mais novas para as mais antigas. `folder` é INBOX por padrão; "All Mail" pesquisa todas as mensagens. `since` e `until` restringem a um período de dias. A pesquisa é executada pelo Proton Mail Bridge neste computador. Nada é marcado como lido. Lê do Proton Mail Bridge neste computador; exige um plano do Proton que inclua o Bridge, com o Bridge em execução.

Entradas obrigatórias

query

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.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "account": {
      "description": "The Proton Mail account: its address, as proton_connect lists it. Optional when one account is connected.",
      "type": "string"
    },
    "folder": {
      "description": "Folder name (default INBOX).",
      "type": "string"
    },
    "limit": {
      "description": "Messages per page (default 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Matches to skip (default 0).",
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    },
    "since": {
      "description": "Only messages received on or after this day (2026-01-31).",
      "type": "string"
    },
    "until": {
      "description": "Only messages received on or before this day.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para proton_search_emails. 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.

{
  "folder": "All Mail",
  "limit": 20,
  "query": "launch checklist",
  "since": "2026-10-01"
}

Windows