从 0 到 1 跑通 Stagehand：能自然语言控制浏览器的 AI 网页自动化框架

从 0 到 1 跑通 Stagehand能自然语言控制浏览器的 AI 网页自动化框架【免费下载链接】stagehandThe SDK For Browser Agents项目地址: https://gitcode.com/GitHub_Trending/stag/stagehandStagehand 是一个用自然语言和代码混合方式控制浏览器的 AI 网页自动化 SDK。它把执行、提取、观察三种原语连同自动缓存与自愈机制打包在一起让自动化脚本在页面改版后也不容易失效。网页表单里的老问题设想一个任务每天登录一个内部系统在一张固定表单里填上八个字段再点提交。第一次用 Playwright 写按 id 找输入框逐个填跑通了。下个月前端改版id 全部换成自动生成的哈希脚本当场报错——你得重新打开开发者工具一个元素一个元素地找改代码再测试。另一条路交给 LLM 代理自己跑省事是省事但每次它点哪里、做什么都不完全可控成本和耗时也飘忽不定。一边是“精确但脆”一边是“灵活但难控”很多团队就卡在这里。Stagehand 如何协调自然语言与代码Stagehand 的思路是让每一步都能选择用哪种模式。对不熟悉的页面写一句自然语言让它自己找到元素并完成操作对页面结构了如指掌的部分直接用代码写死要填哪个字段、点哪个按钮。两种写法可以在同一个脚本里并存切换成本很低。三个核心原语的含义都很直白。act 是“在页面上做一件事”比如点按钮、填表单用一句指令说清楚即可extract 是“从页面里拿结构化数据”你用一个 schema 约定返回的形状比如包含公司名和电话的对象它负责把杂乱的 DOM 解析成干净的字段observe 是“盘点页面上能点什么”面对陌生页面或调试前很实用先看一眼有什么再决定怎么做。跑通第一个 AI 自动化任务准备工作不多安装 Stagehand SDK 和 zod 依赖再准备一个 Browserbase 的 key官方推荐的云端浏览器托管方式省去本地装浏览器的麻烦。文档也支持换成 localBrowser.launch() 直接用本机的浏览器。之后整个脚本只有几十行import { browserbase, Stagehand } from browserbasehq/stagehand; import { z } from zod/v4; const browser await browserbase.launch({ apiKey: process.env.BROWSERBASE_API_KEY }); const stagehand await Stagehand.create({ browser }); const page (await browser.context.pages())[0]; await page.goto(https://example.com); await stagehand.act(点击『登录』按钮); const result await stagehand.extract( 提取当前页面的标题, z.object({ title: z.string() }), ); console.log(result.data); await stagehand.close(); await browser.close();跑起来页面打开、按钮点掉、标题提取并打印这就是最小闭环。想要更完整的玩法比如文件上传、批量操作、自定义模型接入可以翻一翻 TypeScript 示例代码目录第一次接入建议按官方快速入门文档逐步走一遍。页面改版后脚本如何不失效这是 Stagehand 最值钱的部分靠两个机制配合。先是自动缓存。打开 cache 选项后每条指令和它的执行结果会被服务端缓存记录下来下次同样的指令落在同样的页面上直接返回缓存结果——不走 LLM 推理、不花 token速度也比每次现想快得多。缓存键里包含页面内容所以页面真的变了它不会错误地返回旧结果。再是自愈。当缓存下来的选择器失效元素挪了位置或改了名字它不会直接抛错停下而是自动重新推理找到新的元素并更新这一步的执行方式。于是整个脚本变成没变的步骤走缓存变了的部分用 AI 自愈自愈的结果再回灌进缓存。细节可以看仓库里的缓存最佳实践文档。Stagehand 适合哪些人和场景如果你在做网页数据采集、竞品监控、批量表单处理或内部系统 RPA且目标站点偶尔会改版Stagehand 值得一试。如果你需要的是 100% 确定性的回归测试经典 Playwright 仍然够用但在“让 AI 兜底不确定性、让代码保证精确”的那片中间地带Stagehand 是目前少数能直接上生产的浏览器自动化 SDK。【免费下载链接】stagehandThe SDK For Browser Agents项目地址: https://gitcode.com/GitHub_Trending/stag/stagehand创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考