web_read

Automazione web · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Legge la pagina corrente di una sessione web per consentirne l’analisi. mode='text' restituisce il testo visibile ed è il valore predefinito; 'a11y' restituisce un albero accessibile compatto di link, pulsanti e campi, utile per decidere cosa fare clic; 'html' restituisce il DOM grezzo. Se la sessione non è aperta restituisce l’errore esplicito no_session; se non ha ancora caricato una pagina restituisce no_page. Non restituisce mai silenziosamente un risultato vuoto.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — macOS

{
  "properties": {
    "mode": {
      "description": "What to return (default text).",
      "enum": [
        "text",
        "a11y",
        "html"
      ],
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per web_read. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "session": "demo-browser"
}

Windows

Scopo

Legge la pagina corrente di una sessione web per consentirne l’analisi. mode='text' restituisce il testo visibile ed è il valore predefinito; 'a11y' restituisce un albero accessibile compatto di link, pulsanti e campi, utile per decidere l’azione successiva; 'html' restituisce il DOM grezzo. Se la sessione non è aperta o non ha ancora eseguito una navigazione, restituisce un errore esplicito e mai silenziosamente un risultato vuoto. L’output ha un limite massimo; quando viene troncato, la risposta aggiunge una nota che lo segnala.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — Windows

{
  "properties": {
    "mode": {
      "description": "What to return (default text).",
      "enum": [
        "text",
        "a11y",
        "html"
      ],
      "type": "string"
    },
    "session": {
      "description": "Session name (a named login profile). Defaults to 'default'.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Esempio documentale

{
  "session": "demo-browser"
}