Repolode
vercel-labs

vercel-labs/agent-browser

CLI nativa em Rust para agentes de IA controlarem o Chrome com snapshots, referências de elementos e comandos comuns de automação.

Estrelas
44,312
Forks
3,028
Issues abertas
721
Último commit
há 10 horas

O que é?

agent-browser é uma ferramenta de linha de comando para automatizar um navegador, projetada para ser controlada por agentes de IA. Ela inicia o Chrome (baixado pelo comando de instalação integrado ou usando uma instalação existente de Chrome, Brave, Playwright ou Puppeteer que detecta) e oferece ações como abrir URLs, clicar, preencher formulários, fazer capturas de tela e ler o texto da página. Seu principal modelo de interação é um snapshot da árvore de acessibilidade, no qual cada elemento recebe uma referência curta, como @e2, permitindo que um agente interaja com elementos sem precisar escrever seletores complexos.

Além da navegação básica, a CLI oferece gerenciamento de abas e frames, interceptação de requisições de rede e gravação de HAR, gerenciamento de cookies e armazenamento, estado de autenticação salvo, execução em lote de vários comandos em uma única chamada e uma auditoria de acessibilidade com axe-core. Também pode executar um servidor MCP via stdio com perfis de ferramentas selecionáveis, permitindo que clientes MCP usem os mesmos recursos do navegador. A inspeção de componentes React e a medição de Web Vitals ficam disponíveis quando o app é iniciado com o hook do React DevTools.

Recursos principais

  • 01Snapshots da árvore de acessibilidade com referências curtas para interagir com elementos da página
  • 02Instalação do Chrome via Chrome for Testing ou detecção de instalações existentes de Chrome, Brave, Playwright e Puppeteer
  • 03Comandos para cliques, preenchimento de formulários, entrada por teclado e mouse, capturas de tela, exportação para PDF e gravação de vídeo
  • 04Interceptação de rotas de rede, inspeção de requisições e gravação de HAR
  • 05Gerenciamento de abas, frames e diálogos, além de estado de autenticação salvo e importação de cookies
  • 06Servidor MCP via stdio com perfis de ferramentas selecionáveis

Casos de uso

  • Permitir que um agente de IA para programação ou pesquisa navegue, preencha formulários e extraia conteúdo de sites
  • Automatizar fluxos de trabalho de navegador com várias etapas em uma única chamada da CLI em lote
  • Executar auditorias de acessibilidade com axe-core em uma página ou URL pela linha de comando
  • Depurar apps React inspecionando árvores de componentes e atividade de renderização

Início rápido

  1. 1

    Instale o CLI globalmente via npm

    npm install -g agent-browser
  2. 2

    Baixe o Chrome for Testing (somente na primeira vez)

    agent-browser install
  3. 3

    Abra uma página, capture um snapshot e clique em um elemento usando o ref

    agent-browser open example.com

Antes de usar

  • É necessário baixar o Chrome for Testing antes do primeiro uso.
  • Pode ser necessário instalar as dependências do sistema Linux separadamente, e essa instalação pode falhar.

Tópicos

Perguntas frequentes

O que é agent-browser?
CLI nativa em Rust para agentes de IA controlarem o Chrome com snapshots, referências de elementos e comandos comuns de automação. agent-browser é uma ferramenta de linha de comando para automatizar um navegador, projetada para ser controlada por agentes de IA. Ela inicia o Chrome (baixado pelo comando de instalação integrado ou usando uma instalação existente de Chrome, Brave, Playwright ou Puppeteer que detecta) e oferece ações como abrir URLs, clicar, preencher formulários, fazer capturas de tela e ler o texto da página. Seu principal modelo de interação é um snapshot da árvore de acessibilidade, no qual cada elemento recebe uma referência curta, como @e2, permitindo que um agente interaja com elementos sem precisar escrever seletores complexos.
agent-browser é gratuito? Qual é a licença?
agent-browser é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
agent-browser ainda é mantido?
Manutenção ativa. O último commit de agent-browser foi em 20 de out. de 2026.
Para que posso usar agent-browser?
Permitir que um agente de IA para programação ou pesquisa navegue, preencha formulários e extraia conteúdo de sites Automatizar fluxos de trabalho de navegador com várias etapas em uma única chamada da CLI em lote Executar auditorias de acessibilidade com axe-core em uma página ou URL pela linha de comando Depurar apps React inspecionando árvores de componentes e atividade de renderização
Como instalar agent-browser?
Instale o CLI globalmente via npm: npm install -g agent-browser Baixe o Chrome for Testing (somente na primeira vez): agent-browser install Abra uma página, capture um snapshot e clique em um elemento usando o ref: agent-browser open example.com
Onde consigo agent-browser?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/vercel-labs/agent-browser

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados