実際の例を見る
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は、ブラウザの作業手順をコードで管理する開発者向けのSDKです。既知のURLへの移動などは通常のページ操作で記述し、要素の意味の理解や項目の抽出が必要な部分にAIを使えます。例えば製品ページへの移動はコードに任せ、指定したスキーマに沿って製品情報を抽出する構成です。
actは説明した操作を実行し、extractはデータを取得し、observeは候補となる操作を見つけます。Playwright形式の移動、ロケーター、スクリーンショットと併用できます。業務上の手順、成功条件、結果の検証はアプリ側で設計する必要があります。
Stagehandでできること
- 01固定のページ操作にAIによる解釈を組み込みます。
- 02スキーマを指定して構造化データを抽出します。
- 03observeで候補操作を確認してから次の処理を選べます。
実際の作業手順
- 01具体的な作業と成功を示す項目・ページ状態を定義します。
- 02既知の移動はコードで記述し、必要な部分だけact・extract・observeを使います。
- 03項目と最終画面を照合し、エラー処理を整えてから定期実行に接続します。
出典に基づく要約です。製品の主張は独立して検証していません。
他と異なる点
既存のブラウザスクリプトに、一部だけ柔軟な解釈を加えたい場合に適しています。予測可能な処理はコードに残し、AIを使う処理ではページ状態と結果を検証します。
検討に向く人
- レイアウトが変わるサイトの自動化を保守する開発者。
- 既存アプリ内でウェブページから型付きの項目を取得するチーム。
確認すること
- 利用するSDKの環境とモデル・ブラウザ設定を用意してください。
- モデル利用料とホスト型ブラウザの費用は別に確認します。
- レイアウト変更とログイン状態を確認し、AIが常に正しい要素を選ぶと考えないでください。
よくある質問
ブラウザ拡張機能ですか？
公式文書では開発SDKとして説明されています。利用者向け拡張機能ではなく、自分のコードに組み込んで使います。
act・extract・observeの違いは？
actは操作、extractは構造化情報の取得、observeは候補操作の発見です。固定の移動などは通常のブラウザコードで記述できます。
製品情報は2026年10月26日に公式サイトまたは一次資料と照合しました。
