O que é Stagehand?
O Stagehand é um SDK de código aberto, mantido pela empresa de navegadores em nuvem Browserbase, para scripts e agentes que controlam um navegador Chrome real. Em vez de entregar a tarefa inteira a um modelo, ele permite que os desenvolvedores escrevam etapas comuns (goto, click, locator) e chamem um modelo apenas onde a página é imprevisível: act executa uma instrução como 'click the sign in button', observe devolve os seletores que usaria e extract devolve dados validados contra um schema.
A versão 4, lançada em 10 de agosto de 2026, o reconstruiu como um único driver para TypeScript, Python e Go que fala com o Chrome pelo DevTools Protocol, sem dependência do Playwright, e roda parte da lógica como uma extensão dentro do navegador. A 4.3.0 saiu em 20 de outubro de 2026; a linha 3.x ainda recebe correções. O código tem licença MIT.
Ele roda contra um Chrome local ou um navegador em nuvem da Browserbase. Dois recursos, um gateway de modelos que escolhe o modelo por etapa e um cache no servidor de ações repetidas, funcionam apenas na Browserbase.
Quanto custa Stagehand?
| Plano | Preço | O que inclui |
|---|---|---|
| SDK | Free | MIT |
| Browserbase Free | Free | 1 hora |
| Developer | $20/month | 100 horas, depois US$ 0,12/hora |
| Startup | $99/month | 500 horas, depois US$ 0,10/hora |
| Scale | Custom |
SDK gratuito sob MIT. Navegadores da Browserbase: Free 1 hora; Developer US$ 20/mês (100 horas, depois US$ 0,12/hora); Startup US$ 99/mês (500 horas, depois US$ 0,10/hora); Scale sob consulta. O Model Gateway é cobrado a preços do provedor.
Stagehand vale a pena?
O argumento do Stagehand se apoia em uma escolha de design: o modelo é uma ferramenta dentro de um script, não o piloto. Um fluxo de login pode encontrar o campo de e-mail com observe, preenchê-lo a partir de uma variável de ambiente em código comum e usar act apenas para o botão cuja marcação vive mudando. Como observe devolve seletores reais, as senhas nunca passam pelo modelo, o que é um padrão de segurança melhor do que entregar o formulário inteiro a um agente. O Browser Use, a alternativa aberta mais próxima, parte do extremo oposto, com um modelo escolhendo cada etapa.
A versão 4 é quase um produto novo. Ela abandonou o Playwright, oferece SDKs equivalentes para TypeScript (Node 22.18 ou posterior), Python 3.11 e Go 1.26 e passou parte do runtime para uma extensão do navegador para reduzir idas e voltas. O repositório tem atividade à altura: 25.791 estrelas, cerca de 104 issues abertas e quatro releases menores entre 10 de agosto e 20 de outubro de 2026. Equipes que atualizam a partir da 3.x devem tratar isso como uma migração, não como uma troca de versão.
A história de código aberto tem um lado comercial. Em um navegador local, cada chamada act, observe e extract vai para o modelo que você configurar, entre cinco provedores integrados (OpenAI, Anthropic, Google, Groq, Cerebras) ou um callback seu; não há configuração de URL base, então um modelo auto-hospedado precisa desse callback. Na Browserbase, o cache vem ativado por padrão e chamadas repetidas voltam sem gastar tokens, e o Model Gateway cobra a preços do provedor, sem margem, segundo a documentação. Nenhum dos dois funciona localmente, então o jeito mais barato de rodar o Stagehand em volume é na nuvem do seu mantenedor.
Em privacidade, o SDK é mais limpo que seu principal rival. Pela nossa leitura do repositório, a CLI incluída envia eventos de uso ao PostHog (nomes de comandos, versões, durações e códigos de saída, nunca os argumentos brutos), a menos que DO_NOT_TRACK ou BROWSERBASE_TELEMETRY_DISABLED esteja definido, enquanto os pacotes do SDK trazem hooks de tracing OpenTelemetry e nenhuma chamada ao PostHog. O Browser Use, em contraste, vem com telemetria ativada que inclui o texto das tarefas e as URLs.
Onde ele se destaca
Um engenheiro de operações financeiras em uma empresa de SaaS de 50 pessoas
Baixar faturas toda noite de portais de fornecedores que não têm API
Faça login com código de locator comum e credenciais armazenadas, use act para a navegação que quebra com redesenhos e extraia cada tabela de fatura para um schema Zod ou Pydantic. Localmente, o custo são tokens de modelo por etapa de IA; na Browserbase, as etapas repetidas são servidas pelo cache.
Um líder de QA com uma grande suíte do Playwright que quebra a cada redesenho
Fazer os testes end-to-end mais instáveis sobreviverem a mudanças de interface
Porte a suíte com o guia de migração do Playwright e substitua apenas os seletores frágeis por chamadas act ou observe. O resto continua determinístico, então o gasto com modelo fica limitado às etapas que antes falhavam.
Uma gerente de produto orçando um agente que agenda horários para clientes
Estimar o custo mensal de 1.000 execuções de navegador por dia
A três minutos por execução, são cerca de 1.500 horas de navegador por mês: Browserbase Startup a US$ 99 mais 1.000 horas extras a US$ 0,10, cerca de US$ 199, antes dos tokens de modelo e do tráfego de proxy a US$ 10 por GB acima de 5 GB.
Antes de decidir
- Configuração
- pnpm add @browserbasehq/stagehand com Zod 4, pip install stagehand ou go get no módulo Go da v4; execuções locais precisam do Chrome instalado. O quickstart vai de um diretório vazio a um script act, observe e extract funcionando em três passos.
- Integrações
- Provedores integrados OpenAI, Anthropic, Google, Groq e Cerebras, ou um callback para qualquer outro; guias documentados para CrewAI, Mastra, LangChain Deep Agents, Vercel AI SDK, Claude Code, Codex e Cursor; conjuntos de ferramentas de computer use do Claude e da OpenAI; WebMCP; um servidor MCP da Browserbase hospedado.
- Dados e privacidade
- Localmente, o conteúdo das páginas vai apenas para o provedor de modelo que você configurar. Na Browserbase, a nuvem vê cada página e cada valor de formul ário; os dados de sessão são mantidos por 7 dias no Free e 30 dias nos planos pagos, e o HIPAA BAA e o DPA aparecem apenas para o Scale. A telemetria PostHog da CLI é desligada com DO_NOT_TRACK=1. Nenhum aviso de segurança publicado.
- Custo em escala
- Gratuito localmente, exceto pelos tokens de modelo. Na Browserbase, o Developer custa US$ 20 por 100 horas e depois US$ 0,12 por hora, o Startup US$ 99 por 500 horas e depois US$ 0,10, com proxies a US$ 12 ou US$ 10 por GB acima da franquia; ações em cache não gastam tokens.
- Limites
- A concorrência na Browserbase é de 3, 25, 100 ou 250+ navegadores conforme o plano. O gateway rejeita stopSequences e não tem fallback local. A issue aberta mais pedida é o suporte à interface de modelos mais recente do Vercel AI SDK.
O que é bom
- Mistura código determinístico e etapas de IA em um único script
- observe devolve seletores, então os segredos ficam fora dos prompts
- Mesma API em TypeScript, Python e Go
- Sem dependência do Playwright desde a v4
O que não é
- O cache e o gateway de modelos exigem a Browserbase
- Sem opção de URL base para endpoints de modelos personalizados ou locais
- A v4 é uma reescrita incompatível da API 3.x
- Telemetria da CLI ativada por padrão
Ideal para
Equipes de engenharia que querem ajuda de IA nas partes frágeis da automação de navegador, mantendo o resto como código comum e testável.
Alternativas ao Stagehand
Stagehand: perguntas frequentes
- Stagehand vale a pena?
- O Stagehand serve a engenheiros que querem decidir, linha por linha, quanto de um script de navegador um modelo controla, e recompensa discretamente quem roda esse script na Browserbase. Damos nota 4.3 de 5.
- Quanto custa Stagehand?
- SDK gratuito sob MIT. Navegadores da Browserbase: Free 1 hora; Developer US$ 20/mês (100 horas, depois US$ 0,12/hora); Startup US$ 99/mês (500 horas, depois US$ 0,10/hora); Scale sob consulta. O Model Gateway é cobrado a preços do provedor.
- Quais são as desvantagens de Stagehand?
- O cache e o gateway de modelos exigem a Browserbase; sem opção de URL base para endpoints de modelos personalizados ou locais; a v4 é uma reescrita incompatível da API 3.x; telemetria da CLI ativada por padrão.
- Para quem Stagehand é indicado?
- Equipes de engenharia que querem ajuda de IA nas partes frágeis da automação de navegador, mantendo o resto como código comum e testável.
- Quanto custa Stagehand para uma equipe ou em produção?
- Gratuito localmente, exceto pelos tokens de modelo. Na Browserbase, o Developer custa US$ 20 por 100 horas e depois US$ 0,12 por hora, o Startup US$ 99 por 500 horas e depois US$ 0,10, com proxies a US$ 12 ou US$ 10 por GB acima da franquia; ações em cache não gastam tokens.
- Stagehand é seguro para dados da empresa?
- Localmente, o conteúdo das páginas vai apenas para o provedor de modelo que você configurar. Na Browserbase, a nuvem vê cada página e cada valor de formulário; os dados de sessão são mantidos por 7 dias no Free e 30 dias nos planos pagos, e o HIPAA BAA e o DPA aparecem apenas para o Scale. A telemetria PostHog da CLI é desligada com DO_NOT_TRACK=1. Nenhum aviso de segurança publicado.
- Quais são as melhores alternativas ao Stagehand?
- As alternativas mais próximas que analisamos são Browser Use, Crawl4AI, Firecrawl, Skyvern, BrowserOS e Obscura.
Respostas verificadas em 23 de out. de 2026.