介绍
# 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 密钥 | | 隐身模式 | 否 | 是 | | 代理/验证码 (Proxy/CAPTCHA) | 否 | 是 | | 最适用于 | 开发 | 生产/爬取 |
## 最佳实践
1. **始终先导航**，然后再进行交互 2. **查看截图**，在每个命令之后进行验证 3. **描述具体化**，在操作描述中 4. **关闭浏览器**，完成后
## 故障排除
- **未找到 Chrome**：安装 Chrome 或使用 Browserbase 模式 - **操作失败**：使用 `browser observe` 发现可用元素 - **Browserbase 失败**：验证已设置 API 密钥和项目 ID
有关详细示例，请参阅 [EXAMPLES.md](EXAMPLES.md)。 有关 API 参考，请参阅 [REFERENCE.md](REFERENCE.md)。