HyperBrowser
Learn how to automate browser tasks with the HyperBrowser node in StackAI. Discover available actions, required inputs, configurations, and output details.
What is HyperBrowser?
HyperBrowser is a StackAI integration that enables you to automate and control browser-based tasks programmatically. It is ideal for scenarios such as web automation, scraping, testing, and simulating user interactions on websites.
How to use it?
To use HyperBrowser, add the node to your StackAI workflow and configure the "Use Browser" action. This action allows you to define a browser task, set session parameters, and control execution limits. You can monitor the job status and retrieve results or errors upon completion.
Example of Usage
Suppose you want to automate logging into a website and extracting some data. You would specify the task instructions, optionally set session or step limits, and then process the output for further workflow steps.
Available Actions
1. Use Browser
Automate a browser session to perform a specific task.
Inputs
Task (Required)
Description: The task to perform in the browser (e.g., "Log in to example.com and scrape the dashboard data").
Example:
Log in to https://example.com with username 'user' and password 'pass', then extract the text from the dashboard.
Session ID (Optional)
Description: The ID of an existing browser session to use.
Example:
"session_abc123"
Max Failures (Optional, default: 1)
Description: The maximum number of failures allowed before stopping the browser.
Example:
2
Max Steps (Optional, default: 25)
Description: The maximum number of steps to allow before stopping the browser.
Example:
10
Keep Browser Open (Optional, default: false)
Description: Whether to keep the browser open after the task is completed.
Example:
true
Configurations
All configuration options are provided as part of the input parameters above. No additional required configurations.
Outputs
Job ID (Required)
Description: The unique identifier for the browser automation job.
Example:
"job_456def"
Live URL (Required)
Description: The URL to view the live browser session.
Example:
"https://hyperbrowser.live/session/job_456def"
Status (Required)
Description: The current status of the job. Possible values:
pending
,running
,completed
,failed
,stopped
.Example:
"completed"
Final Result (Optional)
Description: The final result or output of the browser task.
Example:
"Dashboard data: { ... }"
Error (Optional)
Description: Error message if the task failed.
Example:
"Login failed: Invalid credentials"
Session Stopped (Optional, default: false)
Description: Indicates if the browser session was stopped after completion.
Example:
true
Summary Table
Task
Yes
The browser task to perform
"Log in and scrape dashboard"
Session ID
No
Use an existing browser session
"session_abc123"
Max Failures
No
Max failures before stopping (default: 1)
2
Max Steps
No
Max steps before stopping (default: 25)
10
Keep Browser Open
No
Keep browser open after task (default: false)
true
Job ID
Yes
Unique job identifier
"job_456def"
Live URL
Yes
URL to view live browser session
",https://hyperbrowser.live/session/job_456def,"
Status
Yes
Job status (,pending,, ,running,, etc.)
"completed"
Final Result
No
Final result of the task
"Dashboard data: { ... }"
Error
No
Error message if failed
"Login failed: Invalid credentials"
Session Stopped
No
Was the session stopped after completion?
true
Best Practices
Always provide a clear and specific task description.
Use session management for multi-step or persistent workflows.
Monitor the job status and handle errors gracefully in your workflow.
HyperBrowser in StackAI empowers you to automate and control browser tasks efficiently, making it a powerful tool for web automation and data extraction.
Last updated
Was this helpful?