run_task
Run plain-English browser tasks to scrape, fill forms, click, extract data, or log in, returning the final result, outcome, and step count from a fresh Chromium session.
Instructions
Run a browser-driven AI task on a fresh real Chromium burner. Returns the final result, the outcome and the total steps. status: completed only means the run ended: read outcome. outcome: failed with status: completed means the agent finished but could not do the task, and final_result says what stopped it. Use this when the user asks for anything web-shaped: scrape, fill, click, extract, login, place an order, search, summarize a page, etc. The browser is a real macOS-Chrome-fingerprinted Chromium with built-in CAPTCHA solving (Turnstile, hCaptcha, reCAPTCHA, ALTCHA, FunCaptcha) and behavioral humanization. Default timeout: 10 minutes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task": "<task>"
},
"name": "run_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| llm | No | LLM identifier, e.g. anthropic:claude-sonnet-5-5, openai:gpt-4o, google:gemini-2.5-flash. Omit to use the workspace's default saved key with its provider's default model; if no key is saved at all, the task runs on Browsa's hosted model and the result says so. Hosted tiers need no LLM key and add a flat credit surcharge per task (see list_models): "browsa" (default hosted model), "browsa-fast" (fastest and lightest), "browsa-smart" (for harder tasks). When you name a model, there is no hosted fallback. | |
| task | Yes | Plain-English instructions for the browser agent. Be specific about what to extract and the desired output shape (JSON, list, etc.). Example: 'Go to news.ycombinator.com and return the top 3 story titles + URLs as JSON.' | |
| country | No | 2-letter egress country (e.g. US, GB, DE). Default: auto. | |
| max_steps | No | Max agent steps. Default 25. Increase for complex multi-page tasks. | |
| reasoning | No | How much the model reasons. Omit for the tier's or the provider's default. | |
| llm_key_id | No | Id of a saved LLM key of this workspace (see list_llm_keys). Default: none. Usually not needed: with no key given, the workspace's default saved key for the provider of llm is used. | |
| profile_id | No | Id of a persistent identity (agt_..., from list_identities). If set, reuses that browser identity (cookies, history, fingerprint stay sticky). Omit for a fresh burner. | |
| initial_url | No | Optional pre-navigation URL (saves the first agent step). | |
| ja3_profile | No | TLS handshake spoof profile (e.g. macos_chrome_137). Useful for TLS-fingerprinted sites. | |
| llm_api_key | No | Per-task LLM provider key. Rarely needed: prefer a saved key (llm_key_id, or the workspace default) so the secret never passes through the chat. Overrides llm_key_id. | |
| timeout_minutes | No | Max wall-clock minutes to wait before returning. Default 10. |