browser

Usage from Agency code:

import { browserUse } from "std::browser"

node main() {
  const result = browserUse("Find the top 3 trending repos on GitHub today")
  print(result.output)
}

Environment Variables: Set BROWSER_USE_API_KEY to your Browser Use API key. Get one at https://cloud.browser-use.com/settings.

Types

BrowserUseResult

type BrowserUseResult = {
  output: string;
  status: string;
  sessionId: string
}

(source)

Functions

browserUse

browserUse(task: string, model: string, maxCostUsd: number, proxyCountryCode: string, timeout: number, apiKey: string, allowedDomains: string[]): Result

Run a browser automation task using natural language via the Browser Use cloud API. Sends the task to a managed browser with stealth capabilities, CAPTCHA solving, and residential proxies. Returns the task output, status, and session ID. Requires a BROWSER_USE_API_KEY environment variable or pass apiKey directly. Available models: "bu-mini" (default), "bu-max", "bu-ultra". Set maxCostUsd to limit spending. Set proxyCountryCode (e.g. "US", "DE") to control geographic routing. Set timeout to control how long to wait for completion (default: 120000ms / 2 minutes). Set allowedDomains to instruct the browser to only visit specific domains.

@param task - Natural language description of the browser task @param model - Model to use ("bu-mini", "bu-max", "bu-ultra") @param maxCostUsd - Maximum cost limit @param proxyCountryCode - Geographic routing code @param timeout - Timeout in milliseconds @param apiKey - Browser Use API key @param allowedDomains - Instruct browser to only visit these domains

Parameters:

Name	Type	Default
task	string
model	string	""
maxCostUsd	number	0
proxyCountryCode	string	""
timeout	number	0
apiKey	string	""
allowedDomains	string[]	[]

Returns: Result

Throws: std::browserUse

(source)