invisible_playwright_mcp README

The project's README from github.com/feder-cr/invisible_playwright_mcp. As one markdown file: README.md.

dots

Every AI agent is a model and a browser.
You can swap the model with one flag. The browser is what the website sees.


Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx --from git+https://github.com/feder-cr/dots dots --openrouter-key sk-or-...

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx --from git+https://github.com/feder-cr/dots dots --openrouter-key sk-or-...

Then open http://127.0.0.1:8765. The conversation on the left, the browser on the right, live.

It all comes down to the browser

When a web agent fails, the model is rarely why. The page never loaded, a challenge appeared, the login expired, the click did not land. All of that happens in the browser, before the model gets to think.

So dots is built around one:

The model is any model on OpenRouter, and --model changes it.

What to ask it

Go to <paste the URL>. One way, Milan to Lisbon, economy, one adult. Check every date from the 12th to the 16th of next month and read the cheapest fare for each day. If a date has no availability, say so. Do not guess a number.

The same browser, in your own assistant

Claude Code, Codex, Gemini CLI or any MCP client: invisible_playwright_mcp gives them this browser as a server. dots is its interface, and dots --help lists every option.


Not affiliated with OpenAI. MIT licensed.

invisible_playwright_mcp (feder-cr/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.
Creator
feder-cr
Size
20.9 MB
Stars
2.8K
Age
18d
Commits · 90 Days