web_click

Automatización web · macOS · Windows

Efecto: ejecución. 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

Hace clic en un elemento de la página actual. `target` es un selector CSS o texto visible (se resuelve de nuevo en cada llamada). Los clics que ENVÍAN un formulario muestran primero una vista previa: llama otra vez con confirm:true para ejecutar; los enlaces y botones comunes se pulsan directamente. Devuelve {url, title, navigated, url_as_of}: `url_as_of` vale "settled" cuando la página terminó de cambiar, y "before_click" junto con navigation_pending:true cuando el clic inició una navegación que aún no terminó. En ese caso, url/title corresponden a la página ANTERIOR al clic, NO al destino: no interpretes que "el clic no hizo nada" ni vuelvas a intentarlo, porque la página ya está cambiando. Lee el destino con web_read o espéralo con web_wait_for. `navigated:false` significa que el clic no cambió de página.

Entradas obligatorias

target

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 declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

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": {
    "confirm": {
      "description": "Required (true) to perform a click that submits a form.",
      "type": "boolean"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "target": {
      "description": "CSS selector or visible text of the element to click.",
      "type": "string"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para web_click. 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.

{
  "confirm": false,
  "session": "demo-browser",
  "target": "button[aria-label='Open navigation']"
}

Windows