playwright_mcp README

README проекта с github.com/oss-invisible/playwright_mcp. Одним файлом markdown: 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)

Ищем в базе…

Что это?Это dots — MCP-сервер на базе Playwright, дающий AI-агентам настоящий пропатченный браузер Firefox, чтобы они могли ходить по вебу, не помечаясь антибот-системами и капчами.
Это стелс-браузер или просто скрипт-обёртка вокруг Playwright?Это не поверхностная обёртка: dots пропатчивает настоящий движок Firefox на C++, так что сам браузер ведёт себя как настоящий пользователь, а затем предоставляет этот браузер AI-агентам как MCP-сервер.
Как его запустить?Установите через PowerShell-скрипт на Windows или shell-скрипт на Linux, затем выполните команду dots, чтобы открыть вид с разделением: диалог с AI с одной стороны, живой браузер — с другой.
С какими кодинг-агентами или моделями он работает?dots выступает MCP-сервером для любого MCP-клиента, включая Claude Code, Codex и Gemini CLI, а базовая модель может быть любой из OpenRouter и переключается флагом --model.
Он гарантирует, что моего агента никогда не заблокируют?Нет — посылка проекта в том, что большинство сбоев агента идут от браузера, а не от модели, поэтому незагружающиеся страницы, выскакивающие проверки, истёкшие логины или промахи по кликам всё же возможны; к тому же это независимый инструмент, не связанный с OpenAI.
Браузер сохраняет мои логины между сессиями?Да, --profile-dir сохраняет cookie и логины между запусками, а --seed держит один и тот же отпечаток (экран, шрифты, GPU, часовой пояс, язык), так что браузер каждый раз выглядит одним и тем же человеком.
Как dots на деле избегает обнаружения?Он патчит сам движок Firefox, поэтому нет ни флага WebDriver, ни протокола DevTools, ни глобальных объектов автоматизации, которые страница могла бы найти, а мышь двигается и клавиши нажимаются так, как это делал бы настоящий человек.
Можно пустить браузер через прокси?Да, флаг --proxy меняет часовой пояс и язык браузера в соответствии с точкой выхода прокси, так что личность остаётся согласованной с местоположением соединения.
Что такое «dots» на самом деле?dots — это интерфейс командной строки этого стелс-браузера: запуск открывает живой вид с разделением чат/браузер, а dots --help перечисляет все доступные опции.
Для каких задач он создан?В примере из README агент проверяет цены на билеты на диапазон дат на туристическом сайте — это указывает на многошаговые задачи просмотра под защитой антиботов, вроде поиска работы и скрейпинга.
Какие есть похожие проекты?puppeteer, selenium, browser-use, nanobrowser, stealth-browser-mcp, ovobrowser, camofox-browser, CloakBrowser
Автор
oss-invisible
Размер
21.6 MB
Звёзды
869
Возраст
1 мес
Коммиты · 90 дней