mcpField
B
browser_visible

browser_visible

github.com/agentscope-aiAgent workflows36.7k52 installsUpdated today
Repository

About browser_visible

A skill explaining the browser launch options for `browser_use.start`, including visible windows and Playwright-managed mode. It clarifies when to choose each setting and notes their prerequisites and limitations.

Key features

  1. 01Explains headed and private modes
  2. 02Shows launch parameter combinations
  3. 03Guidance for choosing private mode
  4. 04Notes browser and environment requirements
  5. 05Explains mode switching behavior

Use cases

  1. 01Launching a visible browser window
  2. 02Using Playwright-managed browser mode on request
  3. 03Checking whether the environment supports headed browsing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/agentscope-ai/qwenpaw --skill browser_visible

After installing, type/browser_visiblein Claude Code to confirm it loaded.

Details

From the project README

Browser Launch Modes

browser_use.start has only two launch modes:

  • Default: managed CDP
  • private_mode=true: Playwright-managed

Parameter meanings:

  • headed: whether to display the browser window
  • private_mode: whether to disable CDP and use Playwright instead

The two parameters are independent and can be freely combined.

Common Usage

Default launch:

{"action": "start"}

Open a visible window:

{"action": "start", "headed": true}

Without CDP:

{"action": "start", "private_mode": true}

Visible window + without CDP:

{"action": "start", "headed": true, "private_mode": true}

When to Use private_mode

Only set private_mode=true when the user explicitly requests one of the following:

  • Does not want the browser managed via CDP
  • Wants to use Playwright instead
  • Wants to reduce the possibility of other local tools connecting via CDP

Otherwise, just set headed=true as needed.

Notes

  • The default is managed CDP
  • The launch mode is entirely determined by the call parameters
  • Managed CDP requires Chrome / Chromium / Edge to be installed locally
  • private_mode=true does not mean absolutely undetectable — it simply switches to Playwright management
  • When the user manually operates the visible browser, the idle timer may not be refreshed
  • private_mode is an explicit parameter for each start call and is not persisted
  • If a browser is already running, you must stop it and then start again to switch launch modes or window visibility
  • Visible mode occupies the desktop and requires a graphical environment; it may not work on servers or headless environments

Comments

Markdown supported