用途
invisible_playwright_mcp 是一个 Playwright MCP 服务器,目标是让 AI 智能体在反检测的隐身 Firefox 浏览器上浏览网页,据称对反机器人机制和验证码不可见。它面向需要真实网页自动化(而非 API)并需要人对页面内容做判断的任务,例如网页抓取、浏览器自动化与计算机操作。
主要能力
- 以隐身 Firefox 引擎驱动网页,按人的方式操作:指针移动、按键输入。
- 提供两种使用方式:
- 通过 MCP 从助手接入(Windows 下使用 PowerShell 安装后,在助手中安装)。
- 独立使用:自带 Web UI,用户提供 OpenRouter 密钥,左侧聊天、右侧实时浏览器,访问 http://127.0.0.1:8765。
- 支持代理、配置文件、种子等选项,用于控制浏览器身份与网络出口。
- 附带 wiki,包含 AI 浏览器智能体指南、被拦截时的检查项、OpenAI Operator 相关文章等;articles/ 中有示例、记录及其输出。
- 同系列还包括:invisible_playwright(Python 库形式的引擎,API 为 Playwright 的)、invisible_core(从种子到指纹、偏好、代理与地理位置)。
使用方式
- MCP 服务器:invisible_playwright_mcp 无子命令即为服务器;invisible-playwright-mcp ui 为界面。
- 命令行选项:
- --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:保存配置文件的目录,使登录和 cookie 在重启后保留。
- --headed:显示浏览器窗口。
- --host、--port:默认 127.0.0.1 和 8765;更改 host 会暴露无认证的界面。
- .env:可在运行目录放置 .env 写入密钥和二进制路径,启动时读取,优先级为 --flag > 环境变量 > .env > 默认值;只读取当前目录,不向上搜索;启动行会列出应用的变量名但不打印值。
- 通过 --openrouter-key 传参会把密钥留在 shell 历史中,Linux 下还会出现在进程列表;使用环境变量或 .env 可避免。
适用场景
- 需要真实浏览器而非 API 的网页自动化任务。
- 需要逐项检查页面内容并做判断的场景,例如逐日查询机票最低票价(资料中给出的示例:米兰到里斯本、经济舱、一件托运行李、一名成人,逐日检查下月 12 至 16 日,日历控件需点击日期而非输入,无可用日期需说明,不得猜测数字)。
- 网页抓取与计算机操作类任务。
限制与注意事项
- 该工具自动化的是用户自己控制的浏览器;应阅读目标网站条款、遵守速率限制,不要提交未经人工阅读的内容。
- 浏览器智能体在用户机器上运行,没有自己的服务器。数据流向:访问的网站会看到浏览器(如同任何 Firefox);模型提供方(Web UI 将对话和智能体读取的页面内容发送给 OpenRouter,使用你的密钥;通过 MCP 则由接入的客户端使用其模型做同样的事);GitHub(首次启动服务器或界面时从 GitHub release 下载引擎,设置代理时下载 GeoIP 数据库;每次浏览器启动还会从 GitHub release 获取一行计数器文件用于统计启动次数,该请求不携带标识符和你的信息,GitHub 会看到任何 HTTPS 请求都会显示的 IP 地址)。
- 除此之外不收集其他数据,也不向作者发送任何内容。会话、配置文件和截图存储在本地(若设置 INVISIBLE_MCP_HOME 则在其下,否则在系统应用数据目录),可自行删除,不会保留在其他地方。
- 许可证:MIT。2026 年 9 月 2 日之前分发的所有内容以 AGPL-3.0 发布并保持该许可。
- 关于收费、价格、平台支持范围等更多细节,资料中暂未提供。