invisible_playwright_mcp:Playwright MCP server undetected by anti-bots and captchas: AI agent browses the web on anti-detect stealth Firefox, Python, undetected browser automation, scraping, computer use.

---

使用该浏览器智能体的两种方式

1. 通过 MCP 在你的助手中使用

在 Windows 的 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

随后将其安装到你的助手中。

Claude Code：

claude plugin marketplace add feder-cr/invisible_playwright_mcp
claude plugin install invisible-playwright-mcp@feder-cr

Codex:

codex plugin marketplace add feder-cr/invisible_playwright_mcp
codex plugin add invisible-playwright-mcp@feder-cr

Gemini CLI：

gemini extensions install https://github.com/feder-cr/invisible_playwright_mcp

2. 独立模式：Web UI

我们负责界面，你只需提供 OpenRouter 密钥。

左侧聊天，右侧实时浏览器。

在 Windows 的 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-...

然后打开 http://127.0.0.1:8765，输入相同的内容。

---

向网页浏览智能体下达什么任务

任何需要真实网页自动化的任务：它需要浏览器而非 API，并需要对页面上有什么做出人的判断。

前往 <paste the URL>。单程，米兰到里斯本，经济舱，1 件托运行李，1 名成人。从下月 12 日到 16 日，逐日查询，并读出每天的最低票价。日期字段是日历控件，因此点击日期，不要输入。如果某天没有可订航班，请说明。不要猜测数字。

它会像人一样操作页面：移动指针、按下按键。

选项：代理、配置、种子

• --openrouter-key 你的密钥，或 OPENROUTER_API_KEY 变量。
• --model OpenRouter 模型 ID，或 INVISIBLE_MCP_MODEL。默认值为 z-ai/glm-5.3-flash。
• --proxy 可选。http://user:pass@proxy.example.com:8080 或 socks5://proxy.example.com:1080。主机和端口都必须提供。时区、区域设置和出站流量会跟随该代理。
• --binary 你已有的引擎二进制文件。它必须是 seal 固定的构建版本，否则启动会拒绝：这会跳过下载，而不是跳过版本检查。
• --seed 一个整数。种子相同，每次运行都生成相同的浏览器身份。
• --profile-dir 用于保存配置的目录，使登录状态和 cookies 在重启后仍然保留。
• --headed 显示浏览器窗口。界面本身也会展示页面。
• --host, --port 127.0.0.1 和 8765。修改主机地址会暴露一个没有认证的接口。

与命令同目录的 .env

与其反复输入密钥和二进制文件路径，不如将它们写在你运行命令所在目录的 .env 中：

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

它会在启动时读取，且在这一过程中 从不覆盖 已经设置的值，因此优先级为 --flag > 环境变量 > .env > 默认值。 它只会读取当前所在目录，不会向上查找，因此从子文件夹中运行时 不会静默地加载到不同的密钥。启动时会打印一行信息，说明实际应用的变量， 但从不打印它们的值。

通过 --openrouter-key 传递密钥，会把密钥留在 shell 历史记录中， 在 Linux 上还会出现在进程列表中。使用环境变量或 .env 中的 OPENROUTER_API_KEY 可以避免这两种情况。

维基：AI 浏览器智能体指南

围绕该智能体的阅读区就在 wiki： AI 浏览器智能体版图：browser-use、Operator 风格与 computer-use 智能体对比、 智能体被拦截时要检查什么 以及 OpenAI Operator 后来怎样了 等等。实际操作示例、对话记录及其输出都在 articles/。

家族其余成员：引擎与核心

选项 1 中的 MCP 服务器就内置在本包中：不带子命令的 invisible_playwright_mcp 是服务器，invisible-playwright-mcp ui 是界面。 对于需要以文件方式配置的客户端，其配置块、设置和工具都在维基页面 MCP 服务器。

• invisible_playwright 引擎，以 Python 库的形式提供，适合用代码而不是提示词来编写。 其 API 就是 Playwright 的。
• invisible_core 从种子、指纹到偏好设置、代理和地理位置。

负责任地使用

本工具会在你的控制下自动化操作浏览器。请先阅读你所访问网站的条款，遵守其速率限制，不要提交任何未经人工阅读的内容。

隐私政策

本浏览器代理运行在你的本机，没有独立的服务器。以下信息会离开你的电脑，以及发送对象如下：

• 你访问的网站会看到这个浏览器，如同看到任意 Firefox 一样。
• 你的模型提供商。 网页界面会使用你的密钥，将对话内容以及代理在页面上读取的内容发送到 OpenRouter。通过 MCP 时，你将其接入的客户端会以其使用的模型执行相同操作。
• GitHub。 引擎会在服务器或界面首次启动时从 GitHub 的 Release 下载；当设置代理时，还会下载 GeoIP 数据库。每次启动浏览器也会从一个 GitHub 的 Release 获取一个单行计数器文件，这就是统计启动次数的方法：该请求不携带任何标识符，也不携带你的任何数据，GitHub 所能看到的只是任何 HTTPS 请求都会显示的内容，即你的 IP 地址。

不会收集其他任何数据，也不会向作者发送任何数据。会话、浏览器配置文件和截图都存储在本地：若设置了 INVISIBLE_MCP_HOME，则存放在该目录下；否则存放在系统的应用数据目录中，由你自行删除；其他任何位置均不保留数据。相关问题请提交到 issues。

许可证

MIT。2026 年 9 月 2 日之前分发的一切内容均按 AGPL-3.0 发布，并继续适用该许可证。