Repolode
browserbase

browserbase/stagehand

SDK en TypeScript, Python y Go para agentes de navegador que controlan Chrome con llamadas en lenguaje natural a act, observe y extract, además de API al estilo Playwright.

Estrellas
25,748
Forks
1,769
Issues abiertos
371
Último commit
hace 10 horas

¿Qué es?

Stagehand es un SDK para crear agentes de navegador que controlan un navegador real y extraen datos estructurados de páginas web. Añade tres primitivas en lenguaje natural —act, observe y extract— a las API de páginas y localizadores al estilo Playwright, de modo que un script puede recorrer un sitio, encontrar elementos y devolver datos validados con un esquema como Zod o Pydantic.

Se ejecuta con una instalación local de Chrome o con los navegadores alojados de Browserbase, que incluyen proxies, contextos persistentes y grabaciones de sesiones. Observe devuelve selectores concretos, lo que permite al código manejar datos de entrada sensibles sin enviarlos al modelo. El proyecto también incluye helpers independientes de fetch y búsqueda para recuperar el contenido de páginas en formato markdown sin iniciar un navegador, así como un servidor MCP alojado que expone herramientas de navegador a agentes de programación.

El SDK está disponible en TypeScript, Python y Go, y se organiza como un monorepo con ejemplos e integraciones para frameworks como Mastra, CrewAI y Vercel AI SDK.

Funciones clave

  • 01API de páginas y localizadores al estilo Playwright para controlar el navegador.
  • 02Métodos act, observe y extract que reciben instrucciones en lenguaje natural.
  • 03Extracción de datos con validación de esquemas mediante Zod o Pydantic.
  • 04Compatibilidad con Chrome local y navegadores alojados de Browserbase con proxies y grabaciones de sesiones.
  • 05Helpers de fetch y búsqueda que devuelven contenido web sin iniciar un navegador.
  • 06SDK en TypeScript, Python y Go.

Casos de uso

  • Extraer tablas o listas estructuradas de sitios que no tienen una API.
  • Automatizar flujos de trabajo web de varios pasos, como inicios de sesión y envíos de formularios.
  • Proporcionar un navegador a agentes de programación mediante el servidor MCP alojado.
  • Migrar una suite de pruebas existente de Playwright para usar pasos en lenguaje natural.

Inicio rápido

  1. 1

    Instala el SDK de TypeScript con pnpm

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

    Instala Google Chrome para ejecutar el navegador en local

  3. 3

    O instala el SDK de Python con pip

    pip install stagehand

Antes de usarlo

  • Para ejecutar en local, Chrome debe estar instalado en el equipo.
  • Las llamadas act, observe y extract necesitan una clave de API de un modelo, como OpenAI, a menos que ejecutes a través de Browserbase.

Temas

Preguntas frecuentes

¿Qué es stagehand?
SDK en TypeScript, Python y Go para agentes de navegador que controlan Chrome con llamadas en lenguaje natural a act, observe y extract, además de API al estilo Playwright. Stagehand es un SDK para crear agentes de navegador que controlan un navegador real y extraen datos estructurados de páginas web. Añade tres primitivas en lenguaje natural —act, observe y extract— a las API de páginas y localizadores al estilo Playwright, de modo que un script puede recorrer un sitio, encontrar elementos y devolver datos validados con un esquema como Zod o Pydantic.
¿stagehand es gratuito? ¿Qué licencia tiene?
stagehand es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿stagehand sigue mantenido?
Mantenimiento activo. El último commit de stagehand fue el 20 oct 2026.
¿Para qué puedo usar stagehand?
Extraer tablas o listas estructuradas de sitios que no tienen una API. Automatizar flujos de trabajo web de varios pasos, como inicios de sesión y envíos de formularios. Proporcionar un navegador a agentes de programación mediante el servidor MCP alojado. Migrar una suite de pruebas existente de Playwright para usar pasos en lenguaje natural.
¿Cómo se instala stagehand?
Instala el SDK de TypeScript con pnpm: pnpm add @browserbasehq/stagehand 'zod@~4.4.3' Instala Google Chrome para ejecutar el navegador en local O instala el SDK de Python con pip: pip install stagehand
¿Dónde consigo stagehand?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/browserbase/stagehand

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados