Local browser automation

Bromato (bro-MAY-toe) is a local browser automation tool, designed for no-code automation platforms like n8n, zapier and Make and custom scripts. It provides a simple HTTP API to control a browser on you local machine. It also provides a tunnel so you can use it from anywhere, even if your n8n instance is running on a VPS or located in n8n cloud.

Built with ❤️ by AI Agents A-Z

Features

• Session management: creating a new session (tab), closing a session
• Navigation: go to a URL, go back, go forward, reload
• Element interactions: click, focus
• File uploads: upload files to file input elements
• Paste in content from using the OS clipboard
• Evaluate JavaScript
• Take a screenshot
• Extract text/HTML/markdown content from the page
• Add network request interceptors
• Exposed locator API to interact with Playwright locators

Use-cases

• Scrape websites that are behind a login wall
• Scrape websites that require JavaScript to render content
• Scrape websites with Cloudflare or other bot protection
• Automate repetitive tasks in your browser
• Automate tasks that require a real browser
• Automate form submissions
• ...

The ability to add network interceptors also allows you to get hard-to-reach data from APIs that are not publicly documented.

Installation

Simply use npx to run Bromato

npx bromato

Available options:

• -p --port <number>: Port to run the Bromato server on (default: 3025)
• -s --subdomain <string>: Desired subdomain to use for the tunnel (default: random)
• -d --userdata <string>: Path to the browser's user data directory (default: ~/.bromato/browser-user-data)

Documentation

API docs

Upcoming features

• MCP server

Acknowledgements

Bromato was built on top of these amazing open-source projects:

• Playwright
• Fastify
• localtunnel
• Patchright