browser-use

### Credential Fixture Review `python scripts/_credentials.py` is review material for the `Browser Use` skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials. # Browser Use Cloud-based AI browser automation. Send a task in plain English, get structured results. ## Quick Start ```bash # Submit task curl -s -X POST https://api.browser-use.com/api/v2/tasks \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"task": "Go to example.com and extract the main heading"}' # Poll for result (replace TASK_ID) curl -s "https://api.browser-use.com/api/v2/tasks/TASK_ID" \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" ``` ## Helper Script Use `scripts/browser-use.sh` for simpler execution: ```bash # Run task and wait for result ./scripts/browser-use.sh "Go to hacker news and get the top 3 stories" # Just submit (don't wait) ./scripts/browser-use.sh --no-wait "Search Google for AI news" ``` ## API Reference ### Create Task ``` POST https://api.browser-use.com/api/v2/tasks ``` Body: ```json { "task": "Plain English description of what to do", "llm": "gemini-3-flash-preview" // optional, default is fast model } ``` Response: ```json { "id": "task-uuid", "sessionId": "session-uuid" } ``` ### Get Task Status ``` GET https://api.browser-use.com/api/v2/tasks/{taskId} ``` Response fields: - `status`: `pending` | `started` | `finished` | `failed` - `output`: Result text when finished - `steps`: Array of actions taken (with screenshots) - `cost`: Cost in dollars (e.g., "0.02") - `isSuccess`: Boolean result ### Stop Task ``` POST https://api.browser-use.com/api/v2/tasks/{taskId}/stop ``` ## Pricing ~$0.01-0.05 per task depending on complexity. Check balance: ```bash curl -s https://api.browser-use.com/api/v2/credits \ -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" ``` ## When to Use - Complex multi-step web workflows - Sites that block simple scraping - Form filling and submissions - When you need screenshots of steps - When local browser control isn't available ## When NOT to Use - Simple page fetches (use `web_fetch` instead) - When you have local browser access (use `browser` tool) - Rapid/high-volume scraping (use Code Use or local scraping)