Stagehand 핵심 요약
Stagehand는 Browserbase 팀이 공개한 차세대 웹 자동화 오픈소스 SDK입니다. Playwright 기반으로 구동되며 act 행동 지시, extract 데이터 추출, observe 상황 관찰 단 3가지 직관적인 자연어 메서드로 복잡한 웹 인터랙션을 완성합니다.
사이트 개편에도 절대 깨지지 않는 자가 복구 웹 자동화 스크립트
기존 셀레니움이나 플레이라이트 스크립트의 최대 고질병은 웹사이트의 CSS 클래스명이나 돔 구조가 조금만 바뀌어도 셀렉터 오류를 뿜으며 멈춰버린다는 점이었습니다.
Stagehand는 LLM의 시각적 및 의미적 추론 능력을 결합합니다. 개발자가 복잡한 돔 트리를 뒤질 필요 없이 결제 버튼을 누르고 이메일을 입력해줘라는 자연어를 건네면, 화면의 현재 상태를 파악하여 가장 적합한 요소를 스스로 찾아 클릭합니다.
전통 Playwright 스크립트 vs Stagehand AI 브라우징 비교표
| 비교 항목 | 전통 Playwright CSS 셀렉터 스크립트 | Stagehand 자연어 웹 에이전트 SDK |
|---|---|---|
| 코드 작성 난이도 | 개발자 도구에서 복잡한 XPath 셀렉터 발굴 | 단 한 줄의 자연어 영문 한글 지시어로 끝 |
| 웹사이트 개편 시 내구성 | HTML 태그 변경 즉시 NoSuchElement 에러 | 시각적 의미를 추론하여 자동 대처 자가 복구 |
| 구조화 데이터 추출 | 정규식 및 문자열 슬라이싱 파싱 필요 | Zod 스키마 정의 시 타입세이프 JSON 반환 |
| 로그인 및 캡차 대처 | 복잡한 쿠키 주입 및 프록시 우회 설정 | Browserbase 클라우드 세션과 원클릭 연동 |
| 헤드리스 디버깅 편의성 | 실패 지점 콘솔 로그 추적 어려움 | 에이전트가 내린 모든 사고 과정 투명 기록 |
타입스크립트에서 3단계로 Stagehand 웹 자동화 구현하기
1단계. stagehand 패키지 설치
npm install @browserbasehq/stagehand playwright zod 명령어로 패키지를 설치합니다.
2단계. Stagehand 인스턴스 초기화 및 브라우저 시작
Stagehand 객체를 생성하고 Claude 3.5 Sonnet 또는 GPT-4o를 언어 모델 백엔드로 지정합니다.
3단계. act와 extract 메서드로 크롤링 완료
page.act 검색창에 맥북 프로를 입력해줘를 실행한 뒤 page.extract 상품명과 가격을 객체로 뽑아줘를 호출하면 정제된 JSON이 반환됩니다.
자주 묻는 질문 FAQ
Q. 로컬 컴퓨터의 일반 크롬 브라우저에서도 실행되나요?
네, 로컬 로컬 머신에 설치된 Playwright 크로미움 브라우저에서 완전 무료로 실행되며 외부 클라우드 결제 없이도 동작합니다.
Q. API 호출 비용이 너무 많이 나오지 않나요?
DOM 트리의 불필요한 스크립트와 스타일 태그를 사전에 압축하여 토큰 소모량을 90퍼센트 이상 줄이는 경량화 파서가 내장되어 있습니다.
Q. 다단계 폼 입력이나 페이지네이션도 스스로 처리하나요?
네, observe 메서드를 루프 안에 넣으면 다음 페이지 버튼이 보일 때까지 자동으로 페이지를 넘기며 데이터를 수집합니다.
