Browserflow icon

Browserflow

Run configurable Browserflow endpoints using metadata-driven input fields.

Run Browser Flow

AI-generated

Overview

This node executes a Browserflow endpoint by sending input values to the specified Browserflow URL and optionally waits for the flow run to complete. It polls the flow run status at configurable intervals until completion or a maximum wait time is reached. This node is useful for automating web browser tasks defined in Browserflow, such as scraping data, automating form submissions, or running custom browser workflows.

Use Case Examples

  1. Automate a product search on Amazon by running a Browserflow endpoint that performs the search and returns results.
  2. Trigger a Browserflow endpoint that logs into a website and extracts user data, returning the data to n8n for further processing.

Properties

Name Meaning
Endpoint URL The URL of the Browserflow endpoint to run. This URL is used to invoke the Browserflow flow and load input fields automatically from its metadata.
Max Wait Seconds Maximum time in seconds to wait and poll for the flow run to complete before returning. Set to 0 to return immediately after invoking the flow.
Poll Interval Seconds Interval in seconds between polling requests to check the flow run status while it is still running.
Input Values Input values to pass to the Browserflow endpoint. These are dynamically loaded from the endpoint metadata and mapped to the flow's input fields.

Output

JSON

  • run_id - The unique identifier of the flow run.
  • flow_run_id - The flow run identifier, synonymous with run_id in some responses.
  • session_id - The session identifier associated with the flow run.
  • status - The current status of the flow run (e.g., running, completed, failed).
  • output - The output data from the flow run, excluding internal metadata fields.
  • error_code - Error code if the flow run failed.
  • message - Error message if the flow run failed.
  • polling_timeout - Indicates if the polling timed out before the flow run completed.
  • polling_wait_ms - Milliseconds waited during polling.
  • polling_max_wait_ms - Maximum milliseconds allowed for polling.
  • polling_run_id - The run ID used during polling.
  • polling_status - The status of the flow run during polling.

Dependencies

  • Requires an API key credential for Browserflow API authentication.

Troubleshooting

  • Common errors include authentication failures (401/403) due to missing or invalid API key credentials.
  • 404 errors indicate the endpoint URL is incorrect or the Browserflow endpoint is inactive.
  • Network errors such as connection refused or timeout may occur if the endpoint is unreachable; using the correct hostname alias for localhost in Docker environments can resolve this.
  • Missing required input fields will cause the node to throw an error specifying which fields are missing.

Links

Discussion