SuperAPI AI 工具集

stagehand

测试与质量

查看项目

更新于 10-15 23:33

技能介绍

用途:Stagehand 用于 AI 驱动的浏览器自动化,在 Playwright 的 Page 对象基础上增加自然语言操作与结构化数据提取,适合选择器脆弱或未知的浏览器流程、测试编排与页面数据抓取。

主要能力:page.act() 用自然语言执行单个动作,如 await page.act('Click the "Sign in" button');page.extract() 配合 Zod schema 提取带类型的数据;page.observe() 在 act/extract 前发现页面元素与可用动作。仍保留 Playwright 的 page.goto()、page.locator()、expect(locator).toBeVisible() 等能力。

使用方式:安装 @browserbasehq/stagehand 与 zod,创建 new Stagehand({ env: "LOCAL" }),await stagehand.init() 后通过 stagehand.page 操作,结束时 await stagehand.close()。act() 每次只写一个具体指令,字面文本加引号;extract() 必须带 schema;动态页面加重试;探索陌生页面先用 observe()。

适用场景:选择器未知或易变的流程、网页结构化数据提取、先用 Stagehand 发现元素再用 Playwright 编写稳定测试的混合方案。

限制:确定性测试应直接用 Playwright;不适合静态抓取与非浏览器任务。每次 act()/extract() 都产生 LLM 调用,需批量提取以降低开销。Stagehand 不自动检测 SPA 路由变化,需重新 observe();默认只操作主框架,iframe 与弹窗需手动切换;视觉范围限于视口,长页面需先滚动;多步认证可结合 Playwright 的 storageState。具体收费、平台与效果资料暂未提供。