copilotbrowser

copilotbrowser is a high-level API to automate web browsers (Chromium, Firefox, and WebKit) with a single API, while also enabling fully autonomous AI agent browser control.

Unique to copilotbrowser is "follow me" mode: an AI agent can watch you navigate a website, learn the steps, and then replay them autonomously — including form fills, multi-step flows, and UI interactions.

Supported Browsers

| Browser | Version | |---------|---------| | Chromium | 146.0.7680.0 | | Firefox | 146.0.1 | | WebKit | 26.0 |

Installation

npm install copilotbrowser
npx copilotbrowser install

The second command downloads the required browser binaries (Chromium, Firefox, WebKit).

MCP Server Setup (AI Agent / Copilot)

To use copilotbrowser as an MCP tool for GitHub Copilot, Claude, or any MCP-compatible AI agent, add the following to your .mcp.json:

{
  "mcpServers": {
    "copilotbrowser": {
      "command": "npx",
      "args": ["copilotbrowser", "run-mcp-server", "--browser", "msedge"]
    }
  }
}

Supported --browser values: msedge, chromium, firefox, webkit.

Developer Setup (from source)

git clone https://github.com/dayour/copilotbrowser
cd copilotbrowser
bash install.sh

or step by step:

npm ci
npm run build
npx copilotbrowser install

Usage

const { chromium } = require('copilotbrowser');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({ path: 'screenshot.png' });
  await browser.close();
})();

Documentation

See the docs/ folder for full API documentation.

License

Apache 2.0