隐身浏览器代理
通过反检测 Firefox 自动操作网页,读取页面内容并返回结果。
- Star 数
- ★ 2.7k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Python
- FA 评分
- 57/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 求职者需要逐个打开职位页面,按指定条件读取并汇总职位信息。
- 不适合
- 要求浏览内容和对话始终留在本机的团队
- 无法接受目标网站访问频率限制的用户
- 源码审查
- 57/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
invisible_playwright_mcp 是一个基于 Python 的 MCP 浏览器代理,使用 Playwright 操作反检测 Firefox。用户可从 Claude Code、Codex 或 Gemini CLI 等 MCP 客户端调用,也可启动独立网页界面与代理交互。代理通过鼠标和键盘操作真实网页,可读取页面并按用户指令汇报结果。网页界面将对话和页面读取内容发送到 OpenRouter;MCP 模式下,客户端会将其发送给所用模型。浏览器、会话资料和截图在本机保存,浏览器引擎首次启动时从 GitHub release 下载。
安装后,invisible_playwright_mcp 不带子命令时作为 MCP server 运行;invisible-playwright-mcp ui 启动网页界面。用户向代理提供网址和操作要求后,它通过指针移动和按键与网页交互,读取页面内容并生成回答。网页界面使用 OpenRouter 模型,需提供 --openrouter-key 或设置 OPENROUTER_API_KEY;MCP 模式使用接入客户端所配置的模型。可选参数包括代理、浏览器配置目录、种子和浏览器二进制路径。
- 求职者需要逐个打开职位页面,按指定条件读取并汇总职位信息。
- 旅行者需要在日历控件中逐日选择日期并比较网页上的机票价格。
- 研究人员需要让代理操作必须通过浏览器访问的页面,并读取其可见内容。
- 需要在本机保留登录状态的用户,可指定
--profile-dir保存 cookies 和配置资料。 - 需要观察代理操作过程的用户,可启动网页界面查看实时浏览器页面。
如何安装或部署这个 Agent?
先安装 uv,然后按所用终端运行安装命令。之后可将插件安装到 Claude Code 或 Codex,也可安装 Gemini CLI 扩展;MCP server 随包提供。独立网页界面需准备 OpenRouter API key。
如何使用这个 Agent?
在 MCP 客户端中安装后,向代理提供网址和明确的浏览任务。要运行独立网页界面,可使用以下命令;启动后打开 http://127.0.0.1:8765。也可把密钥放入当前目录的 .env,变量名为 OPENROUTER_API_KEY。
这个 Agent 有哪些优点和局限?
- 通过指针和按键操作网页,适用于需要与日历等页面控件交互的任务。
- 提供 MCP server 和独立网页界面两种有文档说明的使用入口。
- 支持
--profile-dir持久保存本地登录状态和 cookies。 - 支持配置代理、种子和模型,并可选择显示浏览器窗口。
- 网页界面需要用户提供 OpenRouter API key;MCP 模式也依赖接入客户端所用的模型。
- 需要网络访问目标网站,并在首次启动时下载浏览器引擎;设置代理时还会获取 GeoIP 数据库。
- 项目说明浏览器访问会暴露给目标网站,网页界面对 OpenRouter 发送对话和页面读取内容。
- 更改界面监听主机可能暴露无身份验证的接口。
这个 Agent 与同类方案有什么区别?
README 将其与 browser-use、Operator 风格代理和 computer-use 代理放在同一类 AI 浏览器代理中比较,但未提供具体功能对比数据。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| 隐身浏览器代理 当前 | 57 · 缺口较多 | MCP 服务器免费 + 模型费 | ★ 2.7k | 今天 | Python | Codex · Claude Code |
| Obscura 无头浏览器 | 75 · 表现良好 | 命令行工具免费 | ★ 29k | 1 天前 | Rust | Claude.ai |
| Flyto2 Core | 64 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 484 | 2 天前 | Python | Claude Code |
| AIHawk – AI 浏览器代理 | 59 · 缺口较多 | MCP 服务器免费 + 模型费 | ★ 32k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README说明会向目标网站、模型提供方及GitHub发送哪些数据,也提示命令行参数可能暴露密钥,并建议用环境变量或.env;因此数据流和敏感信息说明较充分。依赖下限有具体缺陷缘由,CI也设只读contents权限。扣分在于浏览器权限较广,未见逐项操作确认或提交前拦截机制;责任提示不等于技术确认。可更换主机地址会暴露无认证界面,副作用和恢复方式主要依靠用户自行控制;本地数据可删除,但没有专门回滚流程。仓库有作者字段和许可证,但发布者身份未核实,维护责任与支持路径说明有限。
README、pyproject和CI对安装方式、命令、平台支持及依赖要求有较多对应说明;CI覆盖多种Python和Windows/Linux,并包含包构建、MCP bundle及浏览器流程检查。依赖使用下限而非完整锁定,部分检查需外部下载或手动运行,故可用性保障并非完整。pyproject记录了若干已知故障及修复版本,能帮助定位问题;但未提供面向用户的系统化故障排查与错误消息目录。
文档给出MCP与独立Web界面两种用法、旅行票价等任务示例,以及代理、浏览器配置和会话目录选项,适用对象和场景较清晰。明确说明更适合需要真实浏览器与页面判断的任务,并提示模型会读取页面内容、不要提交未由人阅读的内容。MCP、UI及参数触发条件有区分;Windows、Linux、Python版本和本地/代理环境也有说明。不过 macOS不在声明支持的平台内,配置及各场景边界仍不是完整矩阵。
README按安装、用法、参数、隐私和许可组织,示例、wiki与文章入口齐备;版本依赖注释和CI揭示了若干限制与变更缘由。MIT许可证文件和项目元数据一致,并说明旧版本仍受AGPL约束。包名、入口和版本信息明确。扣分在于没有集中、面向用户的完整变更日志;虽有作者邮箱和issues入口,但未明确持续维护者或支持承诺。
产品提供MCP浏览器工具及本地聊天/浏览器界面,输出可直接用于网页浏览任务,示例说明了如何指定逐日查询和无结果处理,具备实际价值。成本效益只能部分判断:需要uv、引擎下载、模型服务密钥,且UI按文档经OpenRouter发送对话和页面读取内容;文档未给出典型运行成本或资源消耗数据。
关键安装、数据流、参数和依赖主张可在README、pyproject与CI配置之间追溯;依赖注释列出具体问题和版本下限,CI配置也展示了静态流程覆盖。README将隐私说明和运行模式作为文档陈述,并把行为限制写成注意事项,未将其描述为独立验证结果。扣分在于部分隐私和行为主张没有在所给材料中由实现代码或独立来源交叉证实;静态审查不能验证运行时实际行为。
- 更改默认主机地址可能暴露没有身份验证的界面;不要在不可信网络上公开该界面。
- 页面内容与对话会发送给所选模型提供方;使用持久化浏览器配置目录时,登录态和Cookie会留在本地目录。
- 反检测和绕过验证码是项目的宣传目标;遵守目标网站条款与速率限制,并在提交前由人审阅内容。
常见问题
网页界面会把哪些内容发送到模型服务?
能否在重启后保留网站登录状态?
--profile-dir 指定目录,浏览器配置资料和 cookies 会保留在本机。启动网页界面需要什么?
http://127.0.0.1:8765 打开界面。