start_browser
Launch a real cloud browser and return its CDP URL so you can drive it with Playwright or Puppeteer across multiple tool calls. Stop it when done to end billing.
Instructions
Start a real cloud browser and return its CDP URL, so you can drive it yourself with Playwright or Puppeteer (connect_over_cdp) instead of handing the work to run_task. Use this when you want to write the browser steps, or need the page open across several of your own tool calls. Billed per browser; always call stop_browser when you are done. Without a proxy the browser uses Browsa's data-center IP.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_browser"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ttl | No | How long to keep it, e.g. "5m" or "1h". Default 10m. | |
| proxy | No | One of two forms. Your own proxy: give host and port, or server as "host:port" / "socks5://host:port", plus username and password when it needs them. Or a tier of Browsa's built-in proxy network, billed per GB from credits: {"network": "datacenter"} or {"network": "residential", "country": "us"}, with nothing else next to network. The built-in network works only when the proxy_network tool reports enabled: call it first for the tiers, their countries and the price per GB. | |
| country | No | ISO-2 country, e.g. "us". Takes effect only with a proxy. | |
| os_type | No | Operating system the browser presents, e.g. "macos", "windows". | |
| profile_id | No | Reuse a saved identity (see list_identities) so the browser starts with its cookies and logins. |