浏览器自动化

使用 Stagehand CLI 与 Claude 自动化浏览器交互。

第一步：环境选择（本地 vs 远程）

该技能自动在本地和远程浏览器环境之间进行选择：

• 如果存在 Browserbase API 密钥（.env 文件中存在 BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID）：使用远程 Browserbase 环境
• 如果没有 Browserbase API 密钥：则回退到本地 Chrome 浏览器
• 无需用户提示：选择过程基于可用配置自动进行

设置（仅首次使用）

检查本目录下的 setup.json 文件。如果setupComplete: false：npm install # 安装依赖项 npm link # 创建全局 'browser' 命令

命令

所有命令在两种模式下功能相同：

browser navigate <url> # 访问 URL browser act "<action>" # 自然语言操作 browser extract "<instruction>" ['{}'] # 提取数据（可选模式） browser observe "<query>" # 查找元素 browser screenshot # 截图 browser close # 关闭浏览器

快速示例

browser navigate https://example.com browser act "点击登录按钮" browser extract "获取页面标题" browser close

模式对比

特性

最佳实践

1. 始终先导航再进行交互
2. 查看截图以验证每条命令执行后
3. 描述要具体在操作描述中
4. 关闭浏览器当操作完成时

故障排除

• 未找到Chrome：安装Chrome或使用Browserbase模式
• 操作失败：使用browser observe来发现可用元素
• Browserbase失败：验证API密钥和项目ID是否已设置

详细示例请参见EXAMPLES.md。 API参考请参见REFERENCE.md。