web_eval

Automação Web · macOS · Windows

Efeito: execução. 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

Executa JavaScript arbitrário em uma sessão web e retorna o valor da última expressão, que precisa ser um valor JSON simples (código assíncrono não é aguardado: retorne JSON.stringify(...) ou guarde o resultado e leia-o em uma segunda chamada). Requer confirm=true; sem ele você recebe uma prévia do código e nada é executado. Desativado quando o LMCP está no modo somente leitura. Ferramenta para usuários avançados — uma página pode fornecer código malicioso, então prefira web_find / web_read / web_extract para o uso normal.

Entradas obrigatórias

js

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 declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

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": {
    "confirm": {
      "description": "Must be true to run the code. Without it, returns a preview and runs nothing.",
      "type": "boolean"
    },
    "js": {
      "description": "JavaScript to evaluate on the page; the last expression's value is returned.",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    }
  },
  "required": [
    "js"
  ],
  "type": "object"
}

Exemplo documental

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

{
  "confirm": false,
  "js": "document.title",
  "session": "demo-browser"
}

Windows