浏览器自动化

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

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

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

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

设置（仅首次使用）

检查本目录中的setup.json文件。如果setupComplete: false

npm install    # Install dependencies
npm link       # Create global 'browser' command

：

命令

browser navigate <url>                    # Go to URL
browser act "<action>"                    # Natural language action
browser extract "<instruction>" ['{}']    # Extract data (optional schema)
browser observe "<query>"                 # Discover elements
browser screenshot                        # Take screenshot
browser close                             # Close browser

所有命令在两种模式下都完全一致：

browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close

快速示例

最佳实践

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

故障排除

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

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