Install
Self-hosted n8n, as an owner or admin: Settings > Community Nodes > Install, enter n8n-nodes-browsa, confirm.
docker exec -it n8n sh
mkdir -p ~/.n8n/nodes && cd ~/.n8n/nodes
npm i n8n-nodes-browsa
# then restart n8nConnect
- Key. Create an API key on API keys in the Browsa dashboard. It starts with
agt_live_and is shown once. - Credential. In n8n, create a Browsa API credential and paste the key.
- Test. n8n checks it with
GET /v1/credits. Free.
Operations
| Operation | What it does |
|---|---|
| Robot > Run | Runs 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 Run | Reads a robot run: status, rows, outputs, credits. |
| Recipe > Run | Runs a recipe with Parameters as JSON and waits for the output. |
| Task > Run | A plain-language agent task. |
| Job > Get | Reads a task or crawl job. |
| Page > Scrape, Extract, Screenshot, Crawl | One 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.
- Schedule Trigger. Every day at 8:00.
- Browsa. Robot > Run, Wait for Result on, Output: One Item per Row.
- IF. Price below your target.
- Slack + Google Sheets. Send a message and append a row.
Value 1: {{ $json.output.price }}
is less than
Value 2: 20{{ $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.