Stagehand 소개 — AI 프리미티브와 Playwright 스타일 API

Stagehand 소개

Stagehand 는 두 겹의 제어 계층을 제공합니다.

출처: Introducing Stagehand — 공식문서

두 가지 제어 계층

  1. AI 프리미티브 — act, extract, observe. 자기 회복(self-healing) 자연어 단계.
  2. Playwright 스타일 API — page.goto, click, type, locator, screenshot 등 결정적 브라우저 제어.

act 는 "로그인 버튼 클릭" 같은 자연어 동작을 실행하고, extract 는 정의한 스키마에 맞춰 구조화 데이터를 뽑으며, observe 는 페이지에서 가능한 동작을 발견합니다.

개발자가 Stagehand 를 고르는 이유

  • 정밀한 제어 — AI 액션과 결정적 page API 를 섞어, 정확히 어느 만큼 AI 를 쓸지 스스로 정합니다.
  • 런타임이 브라우저에 — 페이지 옆에서 실행되어 원격 브라우저도 로컬과 비슷하게 빠릅니다.
  • 일급 TypeScript·Python·Go SDK — 지원 언어에서 메서드·옵션이 일치합니다.
  • 타입 있는 추출 — extract 는 스키마로 결과를 검증하고 타입 있는 데이터를 돌려줍니다.
  • 유연한 모델 — 이름으로 지원 프로바이더를 쓰거나 직접 클라이언트 측 LLM 콜백을 제공.
  • 내장 메트릭 — metrics() 로 메서드별 토큰 사용량·추론 시간 확인.
  • 에이전트 하네스용 — "Stagehand 는 브라우저의 손"이 되는 역할.

더 알아보기