list_windows
Pantalla, ventanas e interfaz · macOS · Windows
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
Enumera las ventanas en pantalla de cualquier aplicación con window_id, que posea el ID del paquete de aplicaciones + nombre, título, límites (espacio global, parte superior izquierda, puntos), display_id (CGDirectDisplayID: coincide con list_displays, para que pueda buscar en qué pantalla está una ventana) y is_focused. Los TÍTULOS de las ventanas requiere permiso de grabación de pantalla; sin él, esto devuelve un error permission_required explícito en lugar de un resultado sin título. Filtro app_bundle_id opcional: tenga en cuenta que las aplicaciones de estilo Electron a menudo poseen sus ventanas de un proceso HELPER con un identificador de paquete diferente, por lo que un filtro puede volver vacío mientras la aplicación está claramente en la pantalla. `on_screen_only` es `true` de forma predeterminada y excluye ventanas minimizadas, ocultas y de otros espacios; pasa `false` para verlos. Cuando el resultado está vacío, esta herramienta devuelve un `note` que explica qué filtro lo vació y qué pasar en su lugar; léalo en lugar de concluir que la aplicación no tiene ventanas. window_id se mantiene estable dentro de la sesión para una orientación posterior.
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
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": {
"app_bundle_id": {
"description": "Only return windows owned by this app bundle id.",
"type": "string"
},
"on_screen_only": {
"description": "Only on-screen windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para list_windows. 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.
{}Windows
Propósito
Enumera las ventanas abiertas en esta máquina: ID de ventana, aplicación propietaria (nombre del exe), pid, título, límites {x,y,w,h} e ID de visualización. Solo para Windows (utiliza la ventana Win32 API). Filtre por aplicación con app_bundle_id (una subcadena de nombre exe que coincide en Windows).
Entradas obligatorias
El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.
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 — Windows
{
"properties": {
"app_bundle_id": {
"description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
"type": "string"
},
"on_screen_only": {
"description": "Only return visible, non-empty-title windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para list_windows. 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.
{}