browser

# Browser Automation Automate browser interactions using Stagehand CLI with Claude. ### First: Environment Selection (Local vs Remote) The skill automatically selects between local and remote browser environments: - **If Browserbase API keys exist** (BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID in .env file): Uses remote Browserbase environment - **If no Browserbase API keys**: Falls back to local Chrome browser - **No user prompting**: The selection happens automatically based on available configuration ## Setup (First Time Only) Check `setup.json` in this directory. If `setupComplete: false`: ```bash npm install # Install dependencies npm link # Create global 'browser' command ``` ## Commands All commands work identically in both modes: ```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 ``` ## Quick Example ```bash browser navigate https://example.com browser act "click the Sign In button" browser extract "get the page title" browser close ``` ## Mode Comparison | Feature | Local | Browserbase | |---------|-------|-------------| | Speed | Faster | Slightly slower | | Setup | Chrome required | API key required | | Stealth mode | No | Yes | | Proxy/CAPTCHA | No | Yes | | Best for | Development | Production/scraping | ## Best Practices 1. **Always navigate first** before interacting 2. **View screenshots** after each command to verify 3. **Be specific** in action descriptions 4. **Close browser** when done ## Troubleshooting - **Chrome not found**: Install Chrome or use Browserbase mode - **Action fails**: Use `browser observe` to discover available elements - **Browserbase fails**: Verify API key and project ID are set For detailed examples, see [EXAMPLES.md](EXAMPLES.md). For API reference, see [REFERENCE.md](REFERENCE.md).