Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

fix accuracy issues found by cross-referencing SDK source

ShawnPana709853c30750
diff --git a/skills/cloud/references/browser-api.md b/skills/cloud/references/browser-api.md
index 063aff66d..fbfd9ef35 100644
--- a/skills/cloud/references/browser-api.md
+++ b/skills/cloud/references/browser-api.md
@@ -105,7 +105,7 @@ from selenium.webdriver.chrome.options import Options
browser_session = await client.browsers.create(proxy_country_code="us")
options = Options()
-options.debugger_address = browser_session.cdp_url.replace("wss://", "").replace("ws://", "")
+options.debugger_address = browser_session.cdp_url.replace("ws://", "").replace("/devtools/browser/", "")
driver = webdriver.Chrome(options=options)
driver.get("https://example.com")
diff --git a/skills/cloud/references/features.md b/skills/cloud/references/features.md
index 729df6ae8..bc4109d92 100644
--- a/skills/cloud/references/features.md
+++ b/skills/cloud/references/features.md
@@ -60,13 +60,13 @@ Real-time notifications when tasks complete.
```json
{
- "event": "agent.task.status_update",
- "data": {
- "task_id": "uuid",
- "session_id": "uuid",
+ "type": "agent.task.status_update",
+ "timestamp": "2025-01-15T10:30:00Z",
+ "payload": {
+ "task_id": "task_abc123",
+ "session_id": "session_xyz",
"status": "finished",
- "metadata": {},
- "timestamp": "2024-01-01T00:00:00Z"
+ "metadata": {}
}
}
```
@@ -75,15 +75,22 @@ Real-time notifications when tasks complete.
Headers: `X-Browser-Use-Signature`, `X-Browser-Use-Timestamp`
+The signature is computed over `{timestamp}.{body}` where body is JSON with sorted keys and no extra whitespace. Reject requests older than 5 minutes to prevent replay attacks.
+
```python
-import hmac, hashlib
+import hmac, hashlib, json, time
def verify_webhook(body: bytes, signature: str, timestamp: str, secret: str) -> bool:
- expected = hmac.new(
- secret.encode(),
- f"{timestamp}.{body.decode()}".encode(),
- hashlib.sha256
- ).hexdigest()
+ # Reject requests older than 5 minutes
+ try:
+ ts = int(timestamp)
+ except (ValueError, TypeError):
+ return False
+ if abs(time.time() - ts) > 300:
+ return False
+ payload = json.loads(body)
+ message = f"{timestamp}.{json.dumps(payload, separators=(',', ':'), sort_keys=True)}"
+ expected = hmac.new(secret.encode(), message.encode(), hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature)
```
diff --git a/skills/cloud/references/quickstart.md b/skills/cloud/references/quickstart.md
index 62da0a8fe..69a322af4 100644
--- a/skills/cloud/references/quickstart.md
+++ b/skills/cloud/references/quickstart.md
@@ -118,8 +118,8 @@ Typical task: 10 steps = ~$0.03 (with Browser Use LLM)
### V3 API (Token-Based)
| Model | Input/1M | Output/1M |
|-------|---------|----------|
-| BU Mini | $0.72 | $2.88 |
-| BU Max | $3.60 | $14.40 |
+| BU Mini (Gemini 3 Flash) | ~$0.72 | ~$4.20 |
+| BU Max (Claude Sonnet 4.6) | ~$3.60 | ~$18.00 |
### Browser Sessions
- PAYG: $0.06/hour
diff --git a/skills/open-source/references/agent.md b/skills/open-source/references/agent.md
index 3e8497507..8bb19b097 100644
--- a/skills/open-source/references/agent.md
+++ b/skills/open-source/references/agent.md
@@ -22,12 +22,12 @@ agent = Agent(
)
async def main():
- history = await agent.run(max_steps=100)
+ history = await agent.run(max_steps=500)
```
- `task`: The task to automate
- `llm`: LLM instance (see `models.md`)
-- `max_steps` (default: `100`): Maximum agent steps
+- `max_steps` (default: `500`): Maximum agent steps
## All Parameters
@@ -261,7 +261,7 @@ Fine-tune timeouts via environment variables (values in seconds):
### Browser Actions
| Variable | Default |
|----------|---------|
-| `TIMEOUT_NavigateToUrlEvent` | 15.0 |
+| `TIMEOUT_NavigateToUrlEvent` | 30.0 |
| `TIMEOUT_ClickElementEvent` | 15.0 |
| `TIMEOUT_ClickCoordinateEvent` | 15.0 |
| `TIMEOUT_TypeTextEvent` | 60.0 |