Repolode
browserbase

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. 1

    Instale o SDK de TypeScript com pnpm

    pnpm add @browserbasehq/stagehand 'zod@~4.4.3'
  2. 2

    Instale o Google Chrome para executar o navegador localmente

  3. 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