browserbase/stagehand

해결하는 문제

Stagehand는 브라우저 자동화의 일반적인 문제를 제거합니다. 웹사이트가 레이아웃을 변경하면 스크립트가 깨지고, AI 에이전트가 전체 페이지를 파싱하려고 토큰과 시간을 낭비하는 문제입니다. 개발자와 에이전트에게 일반 영어로 브라우저에 무엇을 할지 지시하는 방법(필드 찾기, 버튼 클릭, 데이터 추출)을 제공하고, 모든 선택자를 하드코딩하거나 사이트가 재설계될 때 로직을 다시 작성하지 않고도 안정적이고 구조화된 결과를 얻을 수 있습니다.

작동 방식

Stagehand는 브라우저(로컬 Chrome 또는 호스팅된 Browserbase 클라우드)와 함께 실행되는 SDK입니다. 자연어 지침을 제공하면 이를 실제 브라우저 작업으로 변환합니다. 세 가지 핵심 함수가 주요 작업을 수행합니다.

• **observe**는 설명한 요소(예: "이메일 입력란")에 대한 실제 CSS 선택자를 찾아 직접 채울 수 있게 하며, AI 모델은 자격 증명에 절대 접근하지 않습니다.
• **act**는 "로그인 버튼 클릭"과 같이 설명한 작업을 수행합니다. 사이트가 변경된 경우 페이지를 다시 평가하므로 자가 치유되어 작업이 계속 작동합니다.
• **extract**는 페이지에서 데이터를 읽고 정의한 스키마(예: 번호, 금액, 지불 상태가 포함된 송장 목록)로 반환하며, Zod(TypeScript), Pydantic(Python) 또는 Go 구조체와 같은 도구로 검증됩니다.

SDK는 Playwright 스타일 API(goto, locator, screenshot)를 기반으로 하므로 이미 알고 있다면 친숙하게 느껴집니다. 페이지 컨텍스트를 에이전트가 필요한 부분만으로 줄여 토큰 사용량을 절감합니다. 또한 브라우저 확장 프로그램으로 실행되어 각 작업의 지연 시간을 줄이고, 중첩된 iframe 및 폐쇄된 Shadow DOM과 같은 최신 웹 복잡성을 지원합니다.

Google Chrome이 설치된 로컬에서 실행하거나 Browserbase 클라우드를 지정할 수 있습니다. 클라우드에서는 모델 게이트웨이가 각 단계에 가장 저렴한 적합한 모델을 자동으로 선택하고, 서버 측 캐싱으로 반복되는 동일한 호출은 토큰을 소비하지 않습니다. Stagehand는 브라우저를 시작하지 않고도 작동하는 경량 search 및 fetch 함수도 제공합니다.

대상 사용자

• 웹사이트와 상호 작용해야 하는 웹 자동화 스크립트 또는 AI 에이전트를 구축하는 개발자.
• 기존 Playwright 코드가 있고 AI 기반 자연어 작업을 추가하려는 팀.
• 호스팅된 MCP 서버를 통해 코딩 에이전트(예: Claude Code 또는 Cursor)에게 웹을 탐색할 수 있는 기능을 부여하려는 모든 사람.
• TypeScript, Python 또는 Go 사용자. Stagehand는 세 언어 모두에서 완전한 SDK를 제공합니다.

주요 특징

• 자연어 브라우저 제어: 관찰, 조작, 추출. 취약한 선택자 불필요.
• 웹사이트 재설계에 적응하는 자가 치유 작업.
• 토큰 효율적: 관련 페이지 컨텍스트만 모델로 전송됩니다.
• TypeScript, Python, Go 전반에 걸친 Playwright 호환 API 표면.
• WebMCP 도구, 클립보드, 배치 명령 및 OTel 추적에 대한 기본 지원.
• 선택적 Browserbase 클라우드 통합(모델 게이트웨이의 자동 모델 선택 및 캐싱).
• 추가 기능: 브라우저 없이 빠른 웹 조회를 위한 search 및 fetch.
• 호스팅된 MCP 서버로 MCP 지원 코딩 에이전트가 웹에서 탐색하고 작업할 수 있습니다.