Stagehand 浏览器 CLI

AI 原生浏览器自动化——用自然语言操控网页。

功能介绍

Stagehand 是一种全新的浏览器自动化范式：不写 CSS 选择器，不写 XPath，直接告诉 Agent 你要做什么。

三大核心原语：

• act(action)：执行操作（点击、填写、悬停）
• extract(instruction)：提取数据（价格、标题、列表）
• observe(instruction)：观察页面（有哪些按钮、表单状态）

底层基于 Playwright，但把选择器的概念完全隐藏——AI 自动理解页面结构并定位元素。

安装步骤

npm install stagehand

# 需要 LLM API Key
export OPENAI_API_KEY=your-key

使用示例

import { Stagehand } from 'stagehand';

const stagehand = new Stagehand({ env: 'LOCAL' });
await stagehand.init();

await stagehand.page.goto('https://example.com');

// 自然语言操作
await stagehand.page.act('click the search button');
await stagehand.page.act('type "AI Agent" in the search box');

// 自然语言提取
const prices = await stagehand.page.extract({
  instruction: 'extract all product prices',
  schema: { prices: { type: 'array', items: { type: 'string' } } }
});

GitHub: https://github.com/nicholaschuayunzhi/stagehand