AI 기반 브라우저 자동화 프레임워크

Read the Docs

Python 구현을 찾으시는 분은 여기를 참조하세요.

Stagehand 는 자연어와 코드로 웹 브라우저를 제어하는 브라우저 자동화 프레임워크입니다. AI 의 능력과 코드의 정밀함을 결합하여 Stagehand 는 웹 자동화를 유연하고 유지보수가 용이하며 실제로 신뢰할 수 있게 합니다.

대부분의 기존 브라우저 자동화 도구는 Selenium, Playwright, 또는 Puppeteer 와 같은 프레임워크에서 저수준 코드를 작성하거나, 프로덕션 환경에서 예측 불가능할 수 있는 고수준 에이전트를 사용해야 합니다. 개발자가 코드와 자연어 (그리고 두 가지 사이의 간극을 연결) 를 선택할 수 있게 함으로써 Stagehand 는 프로덕션 브라우저 자동화를 위한 자연스러운 선택입니다.

• 코드 작성과 자연어를 언제 사용할지 선택: 익숙하지 않은 페이지를 탐색하고 싶을 때 AI 를 사용하고, 정확히 무엇을 하고 싶을 때 코드를 사용합니다.
• AI 기반에서 반복 가능한 워크플로우로 전환: Stagehand 는 AI 액션을 실행하기 전에 미리 보게 해주고, 또한 반복 가능한 액션을 쉽게 캐싱하여 시간과 토큰을 절약하게 도와줍니다.
• 한 번 작성하면 영원히 실행: Stagehand 의 자동 캐싱과 자체 치유는 이전 행동을 기억하고, LLM 추론 없이 실행하며, 웹 사이트가 변경되고 자동화가 깨졌을 때 AI 를 언제 포함해야 하는지 알립니다.

Stagehand 로 시작하려면 한 줄의 코드로 시작하거나, 더 많은 정보를 위해 Quickstart Guide 를 확인하세요:

npx create-browser-app

이제 Stagehand 로 샘플 브라우저 자동화를 만드는 방법을 살펴보겠습니다:

// Stagehand 의 CDP 엔진은 자동화를 위한 최적화된 저수준 인터페이스를 제공합니다
const page = stagehand.context.pages()[0];
await page.goto("https://github.com/browserbase");
...

docs.stagehand.dev 를 방문하여 전체 문서를 확인하세요.

git clone https://github.com/browserbase/stagehand.git
cd stagehand
pnpm install
...

Stagehand 는 LLM 제공자와 Browserbase 자격증표가 있을 때 가장 좋습니다. 이 값을 프로젝트에 추가하려면 다음을 실행하세요:

cp .env.example .env
nano .env # API 키를 추가하기 위해 .env 파일을 편집하세요

gitpkg 를 사용하여 GitHub 브랜치에서 직접 설치하고 빌드할 수 있습니다.

프로젝트의 package.json 에서 설정하세요:

"@browserbasehq/stagehand": "https://gitpkg.now.sh/browserbase/stagehand/packages/core?<branchName>"

참고: 우리는 Stagehand 에 대한 기여를 매우 중요하게 생각합니다! 질문이나 지원을 위해 Discord 커뮤니티에 참여하세요.

우리는 우선순위를 순서대로 신뢰성, 확장성, 속도, 비용 개선에 집중하고 있습니다. 기여에 관심이 있다면 버그 수정과 작은 개선을 시작하는 가장 좋은 방법입니다. 더 복잡한 기능을 위해서는 우리의 목표와 기여가 일치하도록 보장하기 위해 Discord 커뮤니티의 Miguel Gonzalez 또는 Paul Klein 에게 연락하는 것을 강력히 권장합니다.

다음 사람들이 Stagehand 에 대한 주요 기여를 위해 감사드립니다:

• Paul Klein
• Sean McGuire
• Miguel Gonzalez
• Sameel Arif
• Thomas Katwan
• Filip Michalsky
• Anirudh Kamath
• Jeremy Press
• Navid Pour

MIT 라이선스 하에 배포됨.

Copyright 2025 Browserbase, Inc.