介绍
# Browser Automation
使用 Stagehand CLI 和 Claude 自动化浏览器交互。
### 首先：环境选择（本地 vs 远程）
该技能会自动在本地和远程浏览器环境之间进行选择： - **如果存在 Browserbase API 密钥**（.env 文件中的 BROWSERBASE_API_KEY 和 BROWSERBASE_PROJECT_ID）：使用远程 Browserbase 环境 - **如果不存在 Browserbase API 密钥**：回退到本地 Chrome 浏览器 - **无需用户提示**：该选择会基于可用配置自动进行
## 设置（仅需首次执行）
检查本目录下的 `setup.json`。如果 `setupComplete: false`：
```bash npm install # Install dependencies npm link # Create global 'browser' command ```
## 命令
所有命令在两种模式下的工作方式完全相同：
```bash 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 ```
## 快速示例
```bash browser navigate https://example.com browser act "click the Sign In button" browser extract "get the page title" browser close ```
## 模式对比
| 功能 | 本地 | Browserbase | |---------|-------|-------------| | 速度 | 更快 | 稍慢 | | 设置 | 需要安装 Chrome | 需要 API 密钥 | | 隐身模式 | 否 | 是 | | 代理/验证码 | 否 | 是 | | 最适用于 | 开发 | 生产/爬虫 |
## 最佳实践
1. 在交互之前**始终先进行导航** 2. 在每条命令后**查看截图**以进行验证 3. 在操作描述中**保持具体** 4. 完成后**关闭浏览器**
## 故障排查
- **未找到 Chrome**：安装 Chrome 或使用 Browserbase 模式 - **操作失败**：使用 `browser observe` 来发现可用元素 - **Browserbase 失败**：验证 API 密钥和项目 ID 是否已设置
有关详细示例，请参阅 [EXAMPLES.md](EXAMPLES.md)。 有关 API 参考，请参阅 [REFERENCE.md](REFERENCE.md)。