실제 예시 보기
Stagehand Evals: inspect the plan before starting browsers
Author CLI capture shows evals run with --preview, selected harness/model, task counts and quarantined cases. It is a dry-run plan from the evaluation utility, not a browser action, a successful benchmark or an independent performance result. Full native capture is retained.
라이선스
PNG converted to lossless WebP with entire native RGBA equal. No crop, resize or new test. Author shell prompt, model label and dataset notes remain part of the capture.
MIT License
Copyright (c) 2024 Browserbase Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Stagehand source example: act on an Example Domain link
Full original TypeScript file asks the agent to click the More information link and checks its returned success field. Run from the matching Stagehand SDK repository: it imports ../src/index.js and dotenv, needs local Chrome and OPENAI_API_KEY; extract also needs zod/v4. Source model label is preserved without an availability or successful-run claim.
입력 예시
import "dotenv/config";
import { localBrowser, Stagehand } from "../src/index.js";
const { OPENAI_API_KEY } = process.env;
if (!OPENAI_API_KEY) throw new Error();
const browser = await localBrowser.launch({ headless: true });
const stagehand = await Stagehand.create({
browser,
model: {
modelName: "openai/gpt-5.4-mini",
apiKey: OPENAI_API_KEY,
},
});
const [page] = await browser.context.pages();
await page.goto("https://example.com");
const result = await stagehand.act(
"Click the link that provides more information about Example Domain",
);
console.log(JSON.stringify(result.data, null, 2));
if (!result.data.success) {
throw new Error(`act() failed: ${result.data.message}`);
}
await stagehand.close();
await browser.close();
라이선스
Complete original source file unchanged; editorial title, context and prerequisites added. No installation, account operation, model call, form submission or claimed result was executed.
MIT License
Copyright (c) 2024 Browserbase Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Stagehand source example: inspect candidate page actions
Full original TypeScript file asks for the Example Domain link and checks that matching actions were returned. Run from the matching Stagehand SDK repository: it imports ../src/index.js and dotenv, needs local Chrome and OPENAI_API_KEY; extract also needs zod/v4. Source model label is preserved without an availability or successful-run claim.
입력 예시
import "dotenv/config";
import { localBrowser, Stagehand } from "../src/index.js";
const { OPENAI_API_KEY } = process.env;
if (!OPENAI_API_KEY) throw new Error();
const browser = await localBrowser.launch({ headless: true });
const stagehand = await Stagehand.create({
browser,
model: {
modelName: "openai/gpt-5.4-mini",
apiKey: OPENAI_API_KEY,
},
});
const [page] = await browser.context.pages();
await page.goto("https://example.com");
const result = await stagehand.observe(
"Find the link that provides more information about Example Domain",
);
console.log(JSON.stringify(result.data, null, 2));
if (result.data.length === 0) {
throw new Error("observe() returned no matching actions");
}
await stagehand.close();
await browser.close();
라이선스
Complete original source file unchanged; editorial title, context and prerequisites added. No installation, account operation, model call, form submission or claimed result was executed.
MIT License
Copyright (c) 2024 Browserbase Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Stagehand source example: extract a typed page heading
Full original TypeScript file extracts the heading and description from the author’s evaluation site using a Zod schema. Run from the matching Stagehand SDK repository: it imports ../src/index.js and dotenv, needs local Chrome and OPENAI_API_KEY; extract also needs zod/v4. Source model label is preserved without an availability or successful-run claim.
입력 예시
import "dotenv/config";
import { z } from "zod/v4";
import { localBrowser, Stagehand } from "../src/index.js";
const { OPENAI_API_KEY } = process.env;
if (!OPENAI_API_KEY) throw new Error();
const browser = await localBrowser.launch({ headless: true });
const stagehand = await Stagehand.create({
browser,
model: {
modelName: "openai/gpt-5.4-mini",
apiKey: OPENAI_API_KEY,
},
});
const [page] = await browser.context.pages();
await page.goto("https://stagehand-eval-sites.vercel.app/sites/example/");
const result = await stagehand.extract(
"Extract the page heading and description",
z.object({
heading: z.string(),
description: z.string(),
}),
);
console.log(JSON.stringify(result.data, null, 2));
await stagehand.close();
await browser.close();
라이선스
Complete original source file unchanged; editorial title, context and prerequisites added. No installation, account operation, model call, form submission or claimed result was executed.
MIT License
Copyright (c) 2024 Browserbase Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
제품 소개
Stagehand는 브라우저 작업을 코드로 관리하는 개발자를 위한 도구입니다. 알려진 URL로 이동하는 단계는 명확한 코드로 유지하고, 버튼 의미 해석이나 요소 선택, 필드 추출이 필요한 부분에 AI를 사용할 수 있습니다. 예를 들어 제품 페이지는 코드로 열고 제품 정보는 정해진 스키마에 맞춰 추출하는 방식입니다.
핵심 기능은 역할이 다릅니다. act는 설명한 동작을 수행하고, extract는 데이터를 가져오며, observe는 가능한 동작을 찾습니다. Playwright 방식의 이동, 로케이터, 스크린샷과 함께 사용할 수 있습니다. 업무 로직, 성공 조건, 결과 검증은 애플리케이션에서 정의해야 합니다.
Stagehand의 주요 기능
- 01고정된 페이지 작업에 AI 해석을 결합합니다.
- 02정해진 스키마에 따라 필드를 추출합니다.
- 03observe로 가능한 동작을 살펴본 뒤 다음 작업을 선택합니다.
실제 작업 흐름
- 01구체적인 작업과 성공을 나타내는 필드 또는 최종 페이지 상태를 정합니다.
- 02알려진 이동은 코드로 작성하고 필요한 부분에만 act, extract, observe를 사용합니다.
- 03필드와 최종 화면을 확인하고 오류 처리를 마련한 뒤 정기 실행에 연결합니다.
출처에 근거한 요약이며, 제품의 주장을 독립적으로 테스트하지 않았습니다.
차별점
기존 브라우저 스크립트의 일부 단계에 유연한 해석이 필요할 때 적합합니다. 예측 가능한 단계는 코드로 명확히 유지하고 AI에 맡긴 단계는 페이지 상태와 결과를 확인해야 합니다.
추천 대상
- 페이지 배치가 바뀌는 브라우저 자동화를 유지하는 개발자.
- 기존 애플리케이션에 구조화된 웹 필드를 연결하는 팀.
확인할 사항
- 선택한 SDK 환경과 모델·브라우저 설정을 준비해야 합니다.
- 모델과 호스팅 브라우저 비용을 따로 계산합니다. SDK를 사용할 수 있다고 전체 과정이 무료인 것은 아닙니다.
- 배치 변경과 로그인 상태를 확인해야 합니다. AI가 항상 올바른 요소를 고르지는 않습니다.
자주 묻는 질문
브라우저 확장 프로그램인가요?
공식 문서는 개발 SDK로 설명합니다. 최종 사용자용 확장 프로그램이 아니라 직접 작성한 코드에 통합하는 도구입니다.
act, extract, observe는 어떻게 다른가요?
act는 동작 수행, extract는 구조화 정보 추출, observe는 가능한 동작 발견을 맡습니다. 고정된 이동은 일반 브라우저 코드로 처리할 수 있습니다.
제품 정보는 2026년 10월 26일에 공식 사이트 또는 1차 문서와 대조했습니다.
