💻 필요한 컴퓨터 사양

⚡ 설치법

### 4-1. Quick Start

```bash
# TypeScript — 프로젝트 스캐폴딩 (권장)
npx create-browser-app

# TypeScript — 기존 프로젝트에 추가
npm install @browserbasehq/stagehand

# Python
pip install stagehand
# 또는 uv 사용 시
uv pip install stagehand
```

### 4-2. 기본 사용 예시 (TypeScript)

```typescript
import { Stagehand } from "@browserbasehq/stagehand";
import { z } from "zod";

const stagehand = new Stagehand({ env: "LOCAL" });
await stagehand.init();
const page = stagehand.context.pages()[0];
await page.goto("https://github.com/browserbase");

// 단일 액션 실행
await stagehand.act("click on the stagehand repo");

// 구조화 데이터 추출 (Zod 스키마)
const { author, title } = await stagehand.extract(
  "extract the author and title of the PR",
  z.object({
    author: z.string().describe("The username of the PR author"),
    title: z.string().describe("The title of the PR"),
  }),
);

// 다단계 자율 에이전트
const agent = stagehand.agent({
  provider: "anthropic",
  model: "claude-sonnet-4-6",
});
await agent.execute("Get to the latest PR");
```

### 4-3. 환경 변수 설정

```bash
# .env 파일
BROWSERBASE_API_KEY=your_api_key   # Browserbase 클라우드 사용 시
OPENAI_API_KEY=your_key            # OpenAI 모델 사용 시
ANTHROPIC_API_KEY=your_key         # Anthropic 모델 사용 시
GOOGLE_API_KEY=your_key            # Gemini 모델 사용 시
```

🧬 바이오 활용

📝 업데이트 노트

1. vstagehand-server-v3/v3.7.47/22/2026

   이번 업데이트에서는 OpenAI Chat Completions 형식을 지원하여, 연구자가 사용하는 다양한 LLM 엔드포인트를 더욱 유연하게 연결할 수 있게 되었어요. 덕분에 생명공학 데이터 분석에 특화된 맞춤형 모델을 Stagehand의 웹 자동화 워크플로우에 손쉽게 통합하여 활용할 수 있습니다. 또한 실험 경로(trajectories)를 그룹화하고 관리하는 기능이 개선되어, 복잡한 웹 기반 생물학적 데이터 수집 과정의 추적과 디버깅이 한층 정교해졌어요.

2. vstagehand-server-v3/v3.7.37/16/2026

   Stagehand v3.7.3 업데이트에서는 데이터 추출(extract) 및 관찰(observe) 기능의 오류가 수정되어, 웹상의 논문이나 실험 데이터를 수집하는 자동화 작업이 더욱 안정적으로 수행될 수 있습니다. 최신 AI 모델들의 비용 정보가 업데이트됨에 따라, 연구 예산과 작업 복잡도에 맞춰 가장 효율적인 모델을 선택해 활용하기 좋아졌습니다. 또한 도메인 정책 설정 관련 문서가 보강되어, 특정 학술 사이트나 데이터베이스를 대상으로 하는 자동화 에이전트의 접근 제어를 더욱 정교하게 관리할 수 있습니다.

3. v@browserbasehq/stagehand@3.7.07/13/2026

   Stagehand v3에서는 특정 도메인만 허용하거나 차단하는 정책 설정 기능이 추가되어, PubMed나 UniProt 같은 신뢰할 수 있는 학술 데이터베이스로만 탐색 범위를 안전하게 제한할 수 있습니다. 또한, 텍스트 데이터의 손상된 부분을 자동으로 복구하는 기능이 개선되어, 복잡한 단백질 서열이나 화학식 데이터를 수집할 때 발생할 수 있는 데이터 왜곡 오류를 방지합니다. 더불어 팝업 자동 차단 및 자동화 동작의 안정성이 향상되어, 웹 기반의 생물정보학 데이터 크롤링 작업을 더욱 정교하고 효율적으로 수행할 수 있습니다.

4. vbrowse@0.9.06/25/2026

   `browse screenshot` 기능이 이제 base64 텍스트 대신 이미지 파일로 직접 저장되도록 변경되어, 웹 기반 실험 결과나 그래프의 시각적 기록을 관리하기 훨씬 편리해졌습니다. 윈도우 환경에서의 경로 인식 오류와 설치 중 무한 대기 문제가 해결되어, 자동화된 데이터 수집 및 모니터링 파이프라인의 안정성이 한층 강화되었습니다. 기존 스크립트와의 호환성을 위한 `--base64` 플래그도 유지되니, 연구 워크플로우에 맞춰 더욱 안정적인 데이터 아카이빙을 시작해 보세요.

5. v@browserbasehq/stagehand@3.6.06/19/2026

   Stagehand v3에서는 Claude 모델의 지원이 강화되어, 복잡한 생물학적 데이터베이스로부터 구조화된 데이터를 더욱 정밀하게 추출할 수 있게 되었습니다. 또한 Azure OpenAI 인증 기능이 추가되어, 보안이 중요한 연구실 환경에서도 안전하게 AI 자동화 도구를 운용할 수 있습니다. 웹 요소 인식 및 캐싱 성능 개선을 통해, 다양한 과학 웹 사이트의 데이터를 수집하는 자동화 프로세스가 더욱 안정적이고 효율적으로 변할 것입니다.

6. v@browserbasehq/stagehand@2.5.96/16/2026

   Stagehand v3는 팝업창 오류 해결과 데이터 추출 도구 업데이트를 통해 웹 자동화의 안정성과 정확도를 높였습니다. 특히 DOM 요청 시 재시도 로직이 강화되어, 대량의 학술 데이터나 실험 정보를 수집할 때 발생할 수 있는 연결 오류를 효과적으로 방지할 수 있습니다. 또한 Haiku 4.5 모델 지원이 추가되어 더욱 지능적인 웹 에이전트 활용이 가능해졌으니, 데이터 수집 자동화가 필요한 연구원님들께 유용한 업데이트입니다.