Repolode
browserbase

browserbase/stagehand

面向浏览器智能体的 TypeScript、Python、Go SDK,可用自然语言执行操作、观察页面与提取数据。

Star
25,748
Fork
1,769
未关闭 Issue
371
最近提交
23小时前

这是什么?

Stagehand 是一个用于构建浏览器智能体的 SDK,可以控制真实浏览器并从网页中提取结构化数据。它在 Playwright 风格的 page 与 locator API 之上,提供 act、observe、extract 三个自然语言原语:脚本可以完成页面点击,定位元素,并按 Zod 或 Pydantic 等 schema 返回经过校验的数据。

项目支持驱动本地 Chrome,也支持 Browserbase 托管的浏览器,后者提供代理、持久化上下文和会话录制。observe 会返回具体的选择器,敏感输入可以由代码直接处理,无需发送给模型。此外还提供无需启动浏览器即可把网页内容抓取为 markdown 的 fetch 与 search 工具,以及可供编码智能体调用浏览器工具的托管 MCP 服务。

SDK 提供 TypeScript、Python 和 Go 版本,采用 monorepo 组织,并附带与 Mastra、CrewAI、Vercel AI SDK 等框架的集成示例。

核心功能

  • 01提供类 Playwright 的 page 与 locator API 控制浏览器。
  • 02act、observe、extract 方法接受自然语言指令。
  • 03结合 Zod 或 Pydantic 进行 schema 校验的数据提取。
  • 04支持本地 Chrome,也支持带代理和会话录制的 Browserbase 托管浏览器。
  • 05提供无需浏览器即可获取网页内容的 fetch 与 search 工具。
  • 06同时提供 TypeScript、Python 和 Go 版本的 SDK。

适用场景

  • 从没有 API 的网站抓取表格或列表等结构化数据。
  • 自动化登录、表单提交等多步骤网页流程。
  • 通过托管 MCP 服务为编码智能体提供浏览器能力。
  • 将现有 Playwright 测试套件逐步改造为自然语言步骤。

快速上手

  1. 1

    使用 pnpm 安装 TypeScript SDK

    pnpm add @browserbasehq/stagehand 'zod@~4.4.3'
  2. 2

    为本地浏览器运行安装 Google Chrome

  3. 3

    或者使用 pip 安装 Python SDK

    pip install stagehand

使用前须知

  • 本地运行需要在机器上安装 Chrome。
  • act、observe 和 extract 调用需要模型 API 密钥(例如 OpenAI),通过 Browserbase 运行除外。

标签

常见问题

stagehand 是什么?
面向浏览器智能体的 TypeScript、Python、Go SDK,可用自然语言执行操作、观察页面与提取数据。 Stagehand 是一个用于构建浏览器智能体的 SDK,可以控制真实浏览器并从网页中提取结构化数据。它在 Playwright 风格的 page 与 locator API 之上,提供 act、observe、extract 三个自然语言原语:脚本可以完成页面点击,定位元素,并按 Zod 或 Pydantic 等 schema 返回经过校验的数据。
stagehand 可以免费使用吗?用的什么许可证?
stagehand 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
stagehand 还在维护吗?
活跃维护中。stagehand 最近一次提交是在 2026年10月20日。
stagehand 适合用来做什么?
从没有 API 的网站抓取表格或列表等结构化数据。 自动化登录、表单提交等多步骤网页流程。 通过托管 MCP 服务为编码智能体提供浏览器能力。 将现有 Playwright 测试套件逐步改造为自然语言步骤。
stagehand 怎么安装和运行?
使用 pnpm 安装 TypeScript SDK: pnpm add @browserbasehq/stagehand 'zod@~4.4.3' 为本地浏览器运行安装 Google Chrome 或者使用 pip 安装 Python SDK: pip install stagehand
在哪里获取 stagehand?
源代码和安装说明在 GitHub 上:https://github.com/browserbase/stagehand

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目