search_emails

Correo electrónico · macOS

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Úselo cuando el usuario quiera buscar correos electrónicos específicos en esta Mac (Apple Mail: cualquier cuenta agregada a Mail.app). Busca asunto y remitente de forma predeterminada; pase scope="body" o scope="all" para buscar también el cuerpo del mensaje (consulte search_coverage en la respuesta; una búsqueda del cuerpo puede ser parcial mientras su índice local aún se está construyendo). Para un buzón (`mailbox`) de correo de Microsoft 365 NO agregado a Mail.app, use m365_search_emails. IMPORTANTE: en máquinas con más de 2 cuentas, llame con account=<name> (desde list_email_accounts). Sin él, y cuando el índice rápido no puede responder, search_emails devuelve la lista de cuentas en lugar de escanearlas todas; escanear cada cuenta en una llamada no tiene límite (`limit`) de tiempo y también puede bloquear el correo para otras solicitudes. Exactamente 1 cuenta no se ve afectada.

Entradas obligatorias

query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "account": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "scope": {
      "default": "metadata",
      "description": "\"metadata\" (default, subject+sender — fast, unchanged behavior), \"body\" (message body only, via a local index — see search_coverage in the response), or \"all\" (subject+sender+body).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para search_emails. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "query": "launch checklist"
}