Skip to main content
Browser Tool logo
  • Category: ai agents
  • Auth: NO_AUTH
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: BROWSER_TOOL
  • Version: 20261101_00

Tools

Slug: BROWSER_TOOL_CREATE_TASKRun an AI-powered browser automation task in a new or existing cloud browser session. The agent can navigate websites, fill forms, extract data and handle multi-step workflows; each task is limited to 25 steps.

Input Parameters

string
required
Natural language instructions for the browser AI agent. Be specific and clear. Examples: ‘Go to amazon.com, search for wireless headphones, and return the top 3 results with prices’, ‘Log into twitter.com and post a tweet saying Hello World’. For multi-step workflows, break them into clear sequential instructions.
object
Domain-specific credentials for automatic login. Map domain patterns to ‘username:password’. Example: {‘https://example.com’: ‘user@email.com:pass123’, ‘https://.google.com’: ‘email@gmail.com:password’}. Wildcards () supported for subdomains.
string
URL to navigate to before starting the task. If not provided, agent starts from blank page.
string
Leave this empty for the first task, a new session will be auto-created. To continue in an existing browser: pass the browser_session_id from a previous CreateTask response. This preserves login state and cookies between tasks. Important: the previous task in this session must be finished or stopped (via StopTask or by waiting for WatchTask to show status=‘finished’) before creating a new task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BROWSER_TOOL_GET_OUTPUT_FILEGet a download URL for a file generated by a task. When a task downloads or creates files (PDFs, images, spreadsheets, etc.), they appear in WatchTask’s outputFiles list. Use this to get a download URL. The download URL is temporary (presigned) - download promptly.

Input Parameters

string
required
File ID from WatchTask’s outputFiles list
string
required
Task ID from CreateTask

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BROWSER_TOOL_GET_SESSIONGet session status and, when available, a live URL for watching a browser session. Access is restricted to sessions associated with the current user profile.

Input Parameters

string
required
The sessionId returned from a CreateTask call you made previously. Only use session IDs from your own CreateTask responses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BROWSER_TOOL_STOP_TASKKill a browser task and its session. Use this when the browser agent is in a bad state: - Task is stuck or taking too long - WatchTask shows the agent going in the wrong direction - Agent is looping or making no progress After stopping, call CreateTask again to start fresh with a new browser.

Input Parameters

string
required
Task ID to stop (from CreateTask)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BROWSER_TOOL_WATCH_TASKPoll a browser task for progress and results, returning on a terminal status or after up to 30 seconds of polling. Results include status, output, current goal and URL, generated files, and incremental steps with screenshot URLs when available.

Input Parameters

string
required
The taskId from CreateTask response
integer
Last step number from a previous WatchTask response (current_step value). Only steps after this will be returned for incremental updates. Omit or pass 0 to get all steps.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not