Biblioteca Python de código aberto para criar agentes de IA que controlam um navegador real, com navegadores stealth opcionais do Browser Use Cloud e API de agentes hospedada.
browserbase/stagehand
SDKs em TypeScript, Python e Go para agentes de navegador que controlam o Chrome com chamadas em linguagem natural para agir, observar e extrair dados, além de APIs no estilo Playwright.
- Estrelas
- 25,748
- Forks
- 1,769
- Issues abertas
- 371
- Último commit
- há 13 horas
O que é?
Stagehand é um SDK para criar agentes de navegador que controlam um navegador real e extraem dados estruturados de páginas da web. Ele adiciona três primitivas em linguagem natural — act, observe e extract — às APIs de página e locator no estilo Playwright, para que um script possa navegar por um site, encontrar elementos e retornar dados validados por um schema, como Zod ou Pydantic.
Ele funciona com uma instalação local do Chrome ou com os navegadores hospedados da Browserbase, que oferecem proxies, contextos persistentes e gravações de sessão. Observe retorna seletores concretos, permitindo que o código lide com entradas sensíveis sem enviá-las ao modelo. O projeto também inclui helpers separados de fetch e search para recuperar o conteúdo de páginas em markdown sem iniciar um navegador, além de um servidor MCP hospedado que disponibiliza ferramentas de navegador para agentes de programação.
O SDK está disponível em TypeScript, Python e Go e é organizado como um monorepo com exemplos e integrações para frameworks como Mastra, CrewAI e Vercel AI SDK.
Recursos principais
- 01APIs de página e locator no estilo Playwright para controlar o navegador.
- 02Métodos act, observe e extract que recebem instruções em linguagem natural.
- 03Extração de dados com validação por schema usando Zod ou Pydantic.
- 04Suporte ao Chrome local e a navegadores hospedados da Browserbase, com proxies e gravações de sessão.
- 05Helpers de fetch e search que retornam conteúdo da web sem iniciar um navegador.
- 06SDKs para TypeScript, Python e Go.
Casos de uso
- Extrair tabelas ou listas estruturadas de sites que não têm API.
- Automatizar fluxos de trabalho web com várias etapas, como logins e envio de formulários.
- Disponibilizar um navegador para agentes de programação por meio do servidor MCP hospedado.
- Migrar uma suíte de testes Playwright existente para etapas em linguagem natural.
Início rápido
- 1
Instale o SDK de TypeScript com pnpm
pnpm add @browserbasehq/stagehand 'zod@~4.4.3' - 2
Instale o Google Chrome para executar o navegador localmente
- 3
Ou instale o SDK de Python com pip
pip install stagehand
Antes de usar
- Para executar localmente, é necessário ter o Chrome instalado na máquina.
- As chamadas act, observe e extract precisam de uma chave de API de modelo, como a da OpenAI, a menos que você execute por meio do Browserbase.
Tópicos
Perguntas frequentes
- O que é stagehand?
- SDKs em TypeScript, Python e Go para agentes de navegador que controlam o Chrome com chamadas em linguagem natural para agir, observar e extrair dados, além de APIs no estilo Playwright. Stagehand é um SDK para criar agentes de navegador que controlam um navegador real e extraem dados estruturados de páginas da web. Ele adiciona três primitivas em linguagem natural — act, observe e extract — às APIs de página e locator no estilo Playwright, para que um script possa navegar por um site, encontrar elementos e retornar dados validados por um schema, como Zod ou Pydantic.
- stagehand é gratuito? Qual é a licença?
- stagehand é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- stagehand ainda é mantido?
- Manutenção ativa. O último commit de stagehand foi em 20 de out. de 2026.
- Para que posso usar stagehand?
- Extrair tabelas ou listas estruturadas de sites que não têm API. Automatizar fluxos de trabalho web com várias etapas, como logins e envio de formulários. Disponibilizar um navegador para agentes de programação por meio do servidor MCP hospedado. Migrar uma suíte de testes Playwright existente para etapas em linguagem natural.
- Como instalar stagehand?
- Instale o SDK de TypeScript com pnpm: pnpm add @browserbasehq/stagehand 'zod@~4.4.3' Instale o Google Chrome para executar o navegador localmente Ou instale o SDK de Python com pip: pip install stagehand
- Onde consigo stagehand?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/browserbase/stagehand
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Crawler web open source em Python que transforma qualquer site em Markdown limpo e pronto para LLMs, com extração estruturada baseada em CSS/LLM e uma API hospedada opcional.
Automação de navegador open source que usa LLMs e visão computacional para executar fluxos de trabalho na web em qualquer site, estendendo o Playwright com comandos de IA.
SDK open source para criar e executar agentes de IA em Python e TypeScript, com ferramentas, MCP, memória e portabilidade entre modelos.
API de navegador open source para agentes de IA e aplicativos, com um sandbox gerenciado do Chrome que você controla usando Puppeteer, Playwright ou Selenium.
Framework Python de código aberto para orquestrar agentes de IA autônomos baseados em funções (Crews) e workflows orientados a eventos (Flows).