browserbase/stagehand

어떤 프로젝트인가요?

핵심 기능

• 01브라우저 제어를 위한 Playwright 스타일 page 및 locator API.
• 02자연어 지시를 받는 act, observe, extract 메서드.
• 03Zod 또는 Pydantic으로 스키마 검증을 거치는 데이터 추출.
• 04로컬 Chrome 지원과 프록시 및 세션 녹화 기능을 갖춘 Browserbase 호스팅 브라우저.
• 05브라우저를 실행하지 않고 웹 콘텐츠를 반환하는 fetch 및 search 헬퍼.
• 06TypeScript, Python, Go SDK.

활용 사례

• API가 없는 사이트에서 구조화된 표나 목록 스크래핑.
• 로그인이나 양식 제출 같은 여러 단계의 웹 작업 자동화.
• 호스팅 MCP 서버를 통해 코딩 에이전트에 브라우저 제공.
• 기존 Playwright 테스트 모음을 자연어 단계 기반으로 전환.

빠른 시작

1. 1

   pnpm으로 TypeScript SDK 설치

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

   로컬에서 브라우저를 실행하려면 Google Chrome 설치

3. 3

   또는 pip으로 Python SDK 설치

   pip install stagehand

사용 전 알아둘 점

• !로컬에서 실행하려면 머신에 Chrome이 설치되어 있어야 합니다.
• !Browserbase를 통해 실행하는 경우가 아니라면 act, observe, extract 호출에 OpenAI와 같은 모델 API 키가 필요합니다.

토픽

자주 묻는 질문

stagehand은(는) 무엇인가요?

자연어 act, observe, extract 호출과 Playwright 스타일 API로 Chrome을 제어하는 브라우저 에이전트용 TypeScript, Python, Go SDK입니다. Stagehand는 실제 브라우저를 제어하고 웹 페이지에서 구조화된 데이터를 가져오는 브라우저 에이전트를 만들기 위한 SDK입니다. Playwright 스타일의 page 및 locator API에 자연어 기반 프리미티브인 act, observe, extract 세 가지를 더해, 스크립트가 사이트를 탐색하고 요소를 찾은 뒤 Zod나 Pydantic 같은 스키마에 맞춰 검증된 데이터를 반환할 수 있습니다.

stagehand은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

stagehand은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

stagehand은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. stagehand의 마지막 커밋은 2026년 10월 20일입니다.

stagehand은(는) 어디에 사용할 수 있나요?

API가 없는 사이트에서 구조화된 표나 목록 스크래핑. 로그인이나 양식 제출 같은 여러 단계의 웹 작업 자동화. 호스팅 MCP 서버를 통해 코딩 에이전트에 브라우저 제공. 기존 Playwright 테스트 모음을 자연어 단계 기반으로 전환.

stagehand는 어떻게 설치하나요?

pnpm으로 TypeScript SDK 설치: pnpm add @browserbasehq/stagehand 'zod@~4.4.3' 로컬에서 브라우저를 실행하려면 Google Chrome 설치 또는 pip으로 Python SDK 설치: pip install stagehand

stagehand은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/browserbase/stagehand