playwright_mcp README

The project's README from github.com/oss-invisible/playwright_mcp. As one markdown file: README.md.

invisible_playwright_mcp, a browser agent anti-bots cannot see. An animation: asked in Claude Code for the cheapest fare on five dates, it opens its Firefox, clicks each day, reads every fare and answers; or it runs on its own with a web UI.

Other AI browser agents get captchas.
This one is invisible to anti-bots.

Decodo residential proxies, free trial (sponsored)
Sponsored


Two ways to use this browser agent

1. From your assistant, over MCP

Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

Then install it in your assistant.

Claude Code:

claude plugin marketplace add oss-invisible/playwright_mcp
claude plugin install invisible-playwright-mcp@oss-invisible

Codex:

codex plugin marketplace add oss-invisible/playwright_mcp
codex plugin add invisible-playwright-mcp@oss-invisible

Gemini CLI:

gemini extensions install https://github.com/oss-invisible/playwright_mcp

2. Standalone: the web UI

We bring the interface, you bring an OpenRouter key. Chat on the left, the live browser on the right.

Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx invisible-playwright-mcp ui --openrouter-key sk-or-...

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx invisible-playwright-mcp ui --openrouter-key sk-or-...

Then open http://127.0.0.1:8765 and type the same thing.


What to ask a web browsing agent

Anything that needs real web automation: a browser rather than an API, and a person's judgement about what is on the page.

Go to <paste the URL>. One way, Milan to Lisbon, economy, one checked bag, one adult. Check every date from the 12th to the 16th of next month, one at a time, and read the cheapest fare for each day. The date field is a calendar widget, so click the days rather than typing them. If a date has no availability, say so. Do not guess a number.

It drives the page the way a person would: the pointer moves, keys are pressed.

Options: proxy, profile, seed

A .env beside the command

Rather than retyping the key and the binary path, put them in a .env in the directory you run from:

OPENROUTER_API_KEY=sk-or-...
STEALTHFOX_BINARY=/path/to/firefox

It is read at startup, and on the way in it never overrides something already set, so the order is --flag > the environment > .env > the default. Only the directory you are in is read - there is no search upwards, so running from a subfolder cannot silently pick up a different key. The startup line names the variables it applied and never prints their values.

Passing --openrouter-key puts the key in your shell history, and on Linux in the process list. OPENROUTER_API_KEY in the environment or in a .env avoids both.

The wiki: AI browser-agent guides

The reading room around the agent lives in the wiki: the AI browser-agent landscape: browser-use, Operator-style and computer-use agents compared, what to check when an agent gets blocked, and what happened to OpenAI Operator, among others. Worked examples, transcripts and their outputs live in articles/.

The rest of the family: engine, core

The MCP server from option 1 ships inside this package: invisible_playwright_mcp with no subcommand is the server, invisible-playwright-mcp ui the interface. Its config blocks for clients that take a file, its settings and its tools are on the wiki page The MCP server.

Using it responsibly

This automates a browser under your control. Read the terms of the sites you point it at, respect their rate limits, and do not submit anything a human has not read.

Privacy Policy

This browser agent runs on your machine and has no server of its own. What leaves your computer, and to whom:

Nothing else is collected and nothing is sent to the author. Sessions, profiles and screenshots are stored locally, under INVISIBLE_MCP_HOME if set and otherwise in the application-data directory of your system, and are yours to delete; nothing is retained anywhere else. Questions go to the issues.

License

MIT. Everything distributed before 2 September 2026 was released under AGPL-3.0 and stays under it.

playwright_mcp (oss-invisible/playwright_mcp)

Searching Database…

What is this?This is dots, a Playwright MCP server that gives AI agents a real, patched Firefox browser so they can browse the web without being flagged by anti-bot systems or captchas.
Is this a stealth browser or just a wrapper script around Playwright?It is not a surface-level wrapper: dots patches a real Firefox engine in C++ so the browser itself behaves like a genuine user, then exposes that browser to AI agents as an MCP server.
How do I get it running?Install it with the PowerShell script on Windows or the shell script on Linux, then run the dots command to open a split view with the AI conversation on one side and the live browser on the other.
Which coding agents or models does it work with?dots acts as an MCP server for any MCP client, including Claude Code, Codex and Gemini CLI, and the underlying model can be anything on OpenRouter, switched with the --model flag.
Does it guarantee my agent never gets blocked?No — the project's premise is that most agent failures come from the browser, not the model, so pages that don't load, challenges that pop up, expired logins or missed clicks can still happen, and it is an independent tool, not affiliated with OpenAI.
Does the browser keep my logins between sessions?Yes, --profile-dir persists cookies and logins across runs, and --seed keeps the same fingerprint (screen, fonts, GPU, timezone, language) so the browser looks like the same person every time.
How does dots actually avoid detection?It patches the Firefox engine itself so there is no WebDriver flag, no DevTools protocol, and no automation globals for a page to find, and it moves the mouse and presses keys the way a real person would.
Can I route the browser through a proxy?Yes, the --proxy flag changes the browser's timezone and language to match wherever the proxy exits from, so the identity stays consistent with the connection location.
What is 'dots' exactly?dots is the command-line interface for this stealth browser — running it opens the live chat/browser split view, and dots --help lists every available option.
What kind of tasks is it built for?The README's example has an agent checking flight prices across a date range on a travel site, pointing to multi-step, anti-bot-protected browsing tasks like job hunting and scraping.
Size
21.6 MB
Stars
869
Age
1mo
Commits · 90 Days