invisible_playwright_mcp

---

两种使用这个浏览器 Agent 的方式

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. 独立使用：网页 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**，输入相同的内容。

---

可以向网页浏览 Agent 提出什么要求

任何需要真实网页自动化的任务：使用浏览器而不是 API，并根据页面内容做出类似人类的判断。

前往 <paste the URL>。单程，从米兰到里斯本，经济舱，带一件托运行李， 一名成人。逐一查询下个月 12 日到 16 日的每个日期，并读取每天最便宜的票价。日期字段是一个日历 小组件，所以请点击日期，而不是输入日期。如果某个日期没有 可用航班，请说明。不要猜测票价。

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

选项：代理、配置文件、种子

• --openrouter-key 你的密钥，或 OPENROUTER_API_KEY 变量。
• --model OpenRouter 模型 ID，或 INVISIBLE_MCP_MODEL。默认为 z-ai/glm-5.3-flash。
• --proxy 可选。http://user:[email protected]:8080 或 socks5://proxy.example.com:1080。主机和端口均为必填项。时区、区域设置和出口流量都会跟随代理。
• --binary 你已有的引擎二进制文件。必须是 seal 指定的构建版本，否则启动将被拒绝：这只会跳过下载，不会跳过版本检查。
• --seed 一个整数。相同种子每次运行都会使用相同的浏览器身份。
• --profile-dir 用于保存配置文件的目录，这样重启后登录状态和 Cookie 仍会保留。
• --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 可以避免这两种情况。

Wiki：AI 浏览器 Agent 指南

围绕该 Agent 的资料汇集在 Wiki 中，包括 AI 浏览器 Agent 全景：对比 browser-use、Operator 风格和 computer-use Agent、 Agent 遭到拦截时的检查事项， 以及 OpenAI Operator 的现状等。实操示例、记录稿及其输出见 articles/。

同系列的其他项目：engine、core

选项 1 中的 MCP 服务已随此软件包一同提供：不带子命令运行 invisible_playwright_mcp 即为服务，运行 invisible-playwright-mcp ui 则打开界面。支持通过文件读取配置的客户端所需的配置块、服务设置和工具，详见 Wiki 页面 MCP 服务。

• invisible_playwright 作为 Python 库的引擎，用于编写代码而非提示词。其 API 与 Playwright 相同。
• invisible_core 从种子到指纹，再到偏好设置、代理和地理位置。

负责任地使用

此工具会自动化由你控制的浏览器。请阅读你访问的网站的条款，遵守其速率限制，并且不要提交任何未经人工阅读的内容。

隐私政策

此浏览器 Agent 在你的计算机上运行，没有自己的服务。以下说明哪些信息会离开你的计算机，以及会发送给谁：

• 你访问的网站会看到浏览器，就像看到任何 Firefox 一样。
• 你的模型提供商。 Web 界面会使用你的密钥，将对话内容以及 Agent 在页面上读取的内容发送至 OpenRouter。通过 MCP 使用时，你接入的客户端也会将这些内容发送给它所使用的模型。
• GitHub。 服务或界面首次启动时，会从 GitHub 发布版本下载引擎；设置代理后，还会下载 GeoIP 数据库。每次启动浏览器时，也会从 GitHub 发布版本获取一个单行计数器文件，启动次数据此统计：请求不包含标识符或你的任何信息，GitHub 能看到的只有任何 HTTPS 请求都会显示的信息，即你的 IP 地址。

不会收集其他任何信息，也不会向作者发送任何信息。会话、配置文件和屏幕截图都存储在本地；如果设置了 INVISIBLE_MCP_HOME，则存储在该目录中，否则存储在系统的应用程序数据目录中。你可以删除这些文件；它们不会在其他任何地方保留。如有疑问，请前往 issues。

许可证

MIT。2026 年 9 月 2 日之前发布的所有内容均采用 AGPL-3.0 许可证发布，并继续遵循该许可证。