浏览器自动化

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

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

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

• 如果存在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. 完成后关闭浏览器when done

故障排除

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

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