A browser work environment for agents

Let your agent act, investigate, and verify

Connect page actions, requests, logs, and environment emulation so your agent can complete tasks and check the results. Turn proven workflows into reusable Skills.

Choose the browser for your task. Connect through the extension, CDP, or an environment Provider.

Let your agent export the weekly report

Illustrative workflow · not a live run
Let your agent export the weekly report

Export last week’s report, check its dates and columns, and save the workflow as a Skill.

Reports
Weekly reportLast week · CSV
weekly-report.csv
Last week selected
PAGE ACTION

Start with an everyday task

Open the reports page, select last week, and start the export.

Open reports
→ Select last week
→ Export CSV
Use the selected browser’s sign-in
Reports
Weekly reportLast week · CSV
weekly-report.csv
Report ready
REQUEST + RESPONSE

Check what the page requested

Inspect the request and response to confirm that the export uses the selected dates.

GET /api/reports      200
range: last_week
format: csv
The request matches the selected date range
Reports
Weekly reportLast week · CSV
weekly-report.csv
Download checked
DOWNLOAD + VERIFICATION

Verify the file you received

Save the CSV and check its dates and columns before reporting completion.

weekly-report.csv
✓ Dates match last week
✓ Expected columns present
A saved file with its contents checked
Reports
Weekly reportLast week · CSV
weekly-report/SKILL.md
Workflow saved
REUSABLE SKILL

Make next week easier

Package the export and validation steps as a Skill with a date range input.

weekly-report/
  SKILL.md
  scripts/export.mjs
Run the Skill next time with a new date range
Open source · Apache-2.0Page automation
Overview

What you can do with Mearl

  • Connect browsers and devices

    Use the extension with everyday Chrome, CDP with a browser or Electron app, or a Provider with an external environment. Cloud requests can reach the browser host through a Connector.

  • Operate web pages

    Ask your agent to read pages, fill forms, transfer files, or take screenshots. Run the same browser actions from the CLI, TypeScript SDK, or MCP.

  • Call APIs with your browser sign-in

    Reuse a signed-in browser session to call a known HTTP endpoint, replay a request, or retrieve data for a report.

  • Debug pages and verify layouts

    Inspect requests, console logs, and tracking events. Mock responses to retest behavior, or overlay a design to compare pixels.

  • Test apps and mini-programs

    Emulate a device, timezone, or App WebView to check JSBridge and container behavior. Run and debug local WeChat mini-programs.

  • Reuse tools and workflows

    Install existing Skills and bb-browser adapters, or turn a proven workflow into a Skill you can run again from an agent, the CLI, or the Toolbox.

Device & App emulation

Bring the App environmentto your browser

Install an App profile to check how your web page behaves inside its host app, from page layout to native interactions.

  • App identitySet the User-Agent and environment signals that select the page’s App-specific behavior.
  • JSBridge callsSimulate the native methods and responses supported by the profile.
  • Container behaviorCheck navigation and WebView behavior with device and timezone emulation.

Example · WeChat mini-program WebView

Regular browser

Regular browser: the page shows both Add to cart and Buy now.

With App emulation

WeChat mini-program WebView: only Buy now appears.

Find a workflow for your role

Getting started

Install Mearl

Run setup to prepare Mearl and connect your agent. Then choose a browser connection; the extension is optional for connecting your everyday browser.

1. Set up Mearl
npx @mearl/setup