Skip to content
Browsa
  1. Guides
  2. n8n

Browsa in n8n

The Browsa node runs robots, recipes, agent tasks and page scrapes on Phantom. The Browsa Trigger starts a workflow when a run ends or a monitor fires.

Install

Self-hosted n8n, as an owner or admin: Settings > Community Nodes > Install, enter n8n-nodes-browsa, confirm.

Terminal (n8n in Docker)
docker exec -it n8n sh
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm i n8n-nodes-browsa
# then restart n8n

Connect

  1. Key. Create an API key on API keys in the Browsa dashboard. It starts with agt_live_ and is shown once.
  2. Credential. In n8n, create a Browsa API credential and paste the key.
  3. Test. n8n checks it with GET /v1/credits. Free.

Operations

OperationWhat it does
Robot > RunRuns a robot (pick from the list or paste its ID) on its saved inputs, or on rows you give as JSON. Waits for the result, or returns the run at once. Output: one item for the run, or one item per row.
Robot > Get RunReads a robot run: status, rows, outputs, credits.
Recipe > RunRuns a recipe with Parameters as JSON and waits for the output.
Task > RunA plain-language agent task.
Job > GetReads a task or crawl job.
Page > Scrape, Extract, Screenshot, CrawlOne page, or a site, in one call.

Browsa Trigger

Pick the Events. When you activate the workflow, the node registers a Browsa webhook. When you deactivate it, the webhook is removed. Each delivery's X-Agents-Signature is checked before the workflow runs.

Robot Run Completed
A robot run ended. Rows, outputs, credits.
Robot Alert
A monitor fired on a row: field, old and new value.
Robot Failed
A robot run failed as a whole. Typed error.
Recipe Run Completed
A recipe run returned its output.
Task Completed
An agent task finished.
Task Needs User
An agent task is waiting for an answer.

Browsa must reach your n8n over a public URL. A localhost n8n cannot receive events; use a tunnel or set WEBHOOK_URL to the public address.

Example: morning price check

Every morning run a robot, and if a price dropped, post to Slack and log it in Google Sheets.

  1. Schedule Trigger. Every day at 8:00.
  2. Browsa. Robot > Run, Wait for Result on, Output: One Item per Row.
  3. IF. Price below your target.
  4. Slack + Google Sheets. Send a message and append a row.
IF condition (number, is less than)
Value 1:  {{ $json.output.price }}
          is less than
Value 2:  20
Slack message
{{ $json.input.url }} is now {{ $json.output.price }}

Simpler: add a monitor on the robot (price goes below 20) and start the workflow with the Browsa Trigger on Robot Alert. No IF needed.

Next steps

Connect n8n to Browsa.

100 free credits. No card, no subscription.