browserbase/stagehand-python

해결하는 문제

Stagehand는 자연어와 코드를 혼합하여 웹 브라우저를 제어할 수 있는 브라우저 자동화 프레임워크입니다. 대부분의 브라우저 자동화 도구는 너무 저수준(예: Selenium 또는 Playwright)이거나 너무 예측 불가능(예: 고급 AI 에이전트)합니다. Stagehand는 그 격차를 메우려고 합니다. 익숙하지 않은 페이지에는 AI를 사용하고, 정확히 무엇을 해야 하는지 알 때는 정밀한 코드로 대체할 수 있습니다. 이 Python SDK는 Stagehand API와 통신하여 클릭, 관찰, 데이터 추출, 다단계 지침 실행과 같은 브라우저 작업을 수행합니다.

참고: 이 특정 저장소(stagehand-python)는 더 이상 유지 관리되지 않습니다. 공식 Stagehand Python 소스는 기본 Stagehand 모노레포(browserbase/stagehand)로 이동했으며, 이 버전은 업데이트, 버그 수정 또는 보안 패치를 받지 않습니다.

작동 방식

SDK는 Stagehand API의 클라이언트입니다. 세션을 시작하고, 브라우저를 연결하고(Browserbase 또는 로컬 Playwright 브라우저를 통해), observe, act, extract, execute와 같은 메서드를 호출하여 작업을 수행합니다. 이러한 메서드는 자연어 지침을 받아들이고 결과를 Pydantic 모델로 반환합니다. SDK는 동기(Stagehand) 및 비동기(AsyncStagehand) 클라이언트를 모두 지원하며, API 키와 환경 변수로 구성할 수 있습니다. Server-Sent Events(SSE)를 통한 스트리밍 응답, 원시 응답 액세스, 자동 재시도 및 시간 초과를 포함한 오류 처리가 포함됩니다. README에는 Playwright를 사용하여 원격 브라우저에 연결하고, 요소를 관찰하고, 링크를 클릭하고, 스키마를 기반으로 구조화된 데이터를 추출하는 SDK 사용 예제가 나와 있습니다.

대상 사용자

AI를 사용하여 안정적이고 프로덕션 등급의 브라우저 자동화를 구축하려는 개발자. 자주 변경되는 웹사이트와의 상호 작용을 자동화하고 인간이 작성한 코드와 AI 유연성의 혼합이 필요한 팀을 위한 것입니다. 이 SDK는 Stagehand API와 API 키(모델 및 browserbase용)가 필요하므로 클라우드 기반 브라우저 오케스트레이션에 익숙한 사용자를 대상으로 합니다.

주요 기능

• 자연어 + 코드 하이브리드: 작업에 대해 AI 기반 지침과 명시적 코드 중에서 선택하여 제어성과 안정성을 제공합니다.
• 세션 기반 API: 세션을 시작하고, 브라우저를 연결하고, observe, act, extract, execute와 같은 작업을 실행합니다.
• 스트리밍 및 원시 응답: Server-Sent Events(SSE) 스트리밍 및 디버깅을 위한 원시 HTTP 응답 액세스를 지원합니다.
• 여러 클라이언트 모드: 동기 및 비동기 클라이언트, 더 나은 동시성을 위한 aiohttp 지원.
• 구성 가능한 오류 처리: 재시도, 시간 초과 및 엄격한 응답 검증 옵션.
• 더 이상 사용되지 않는 상태: 저장소가 더 이상 유지 관리되지 않습니다. 공식 SDK는 새 위치(browserbase/stagehand)로 안내됩니다.