我做网页自动化时最容易卡住的地方往往不是点击按钮而是让脚本接上“那个已经登录好的浏览器”。新开一个 Chrome 不难麻烦在后面重新登录、重新过验证、找回原来的页面。电脑里如果同时开着 Chrome、Edge、QQ 浏览器还有几个 EasyBR 环境就得再确认一遍这次操作到底会落在哪个账号上。我做Easy WebBridge就是想把这件事简单一点让 AI Agent 连接我已经打开、已经登录的真实浏览器继续完成当前的网页工作不必每次都从空白浏览器开始。项目地址https://github.com/xxjrq/easy-webbridgeEasy WebBridge 到底是什么Easy WebBridge 是一个运行在本机的浏览器连接层。它由本机 Bridge、浏览器扩展以及 CLI、HTTP API 和 Agent Skill 组成。Bridge 默认只监听本机127.0.0.1:17777。浏览器扩展负责把当前环境连接进来Agent 则通过明确的browserId找到目标浏览器。当前 Profile 里的 Cookie、Local Storage 和登录状态仍属于原来的浏览器只要登录状态没有过期任务通常不用从登录页重新开始。可以把调用链理解成这样Codex / Claude Code / 其他 AI Agent | Easy WebBridge 本机 Bridge | 指定 browserId | 已登录的 Chrome / Edge / QQ 浏览器 / Chromium / EasyBR它为什么一定要指定 browserId多浏览器、多账号环境里最危险的错误通常不是“点击没有生效”而是“点击生效了但点到了另一个账号”。Easy WebBridge 给每个在线浏览器分配独立的browserId。任务开始前先列出在线环境再选择明确目标命令不会广播给所有浏览器也不应该靠网页昵称猜账号。页面发生跳转、上传或弹窗变化后Agent 还需要重新读取页面状态。网页自动化真正容易出问题的地方往往不是点击本身而是页面已经变了脚本仍拿着旧状态继续往下走。对我来说“知道操作发生在哪个环境、发生之后页面变成什么样”比再增加一个全自动按钮更重要。Easy WebBridge 能做哪些网页工作它适合处理需要“接着当前页面干活”的任务例如读取网页、后台状态和通知打开、查找、切换和关闭标签页点击、填写、滚动读取 DOM 或语义快照截取当前视口、整页或指定元素上传文件、触发下载、导出 PDF查看网络请求和响应执行受控 JavaScript 或 CDP 命令把一组页面放进任务专属标签组结束时只关闭本次任务创建的页面。内容后台、CMS、CRM、SaaS 管理台、App Store Connect、Google Play Console都属于这类已经有登录上下文的网页。一个更稳妥的用法是先读页面核对账号和状态再整理资料、填写字段、上传文件到了提交、发布、发送、付款或删除这一步停下来让人确认。自动化做得快并不难难的是不要在错误的账号里做得很快。Easy WebBridge 和 Playwright 有什么区别Playwright、Selenium 很适合自动化测试。它们擅长准备隔离、干净、可以重复运行的浏览器环境用同一套步骤反复验证页面。Easy WebBridge 处理的是另一类任务用户已经在真实浏览器里登录页面上有现成的上下文Agent 要在这个上下文里继续读、写和核对。如果任务需要可重复的无状态测试环境Playwright 依然合适如果任务依赖当前账号、当前页面和当前登录态Easy WebBridge 会更直接。两者不是替代关系选哪个取决于任务从哪里开始。一次真实任务是怎么执行的假设我已经在 Edge 里登录了内容后台同时 Chrome 还登录着另一个账号。任务会按下面的顺序走Easy WebBridge 列出在线浏览器的名称、状态和browserId。我或业务系统明确选择 Edge 对应的browserId。Agent 创建本次任务专属的 session 和标签组在组内复用页面。Agent 读取页面确认账号、URL 和当前状态再开始填写或上传。页面跳转后重新读取需要改变线上状态时根据本次授权决定是否提交。任务结束后只关闭本次创建的 session不碰用户原有标签页。给 Codex 或其他 Agent 的提示词不需要写得很复杂。可以先从只读检查开始使用 Easy WebBridge 列出已连接浏览器只告诉我名称、browserId 和在线状态。 不要打开页面也不要修改任何内容。需要处理后台时再明确目标和停点使用我指定的 browserId 打开已经登录的内容后台检查草稿缺少哪些字段。 可以填写我提供的资料但停在发布前等我确认。支持哪些浏览器项目当前已经实测 Google Chrome、Microsoft Edge、QQ 浏览器、Chromium 和 EasyBR 多开环境。其他 Chromium 内核浏览器如果允许安装 Manifest V3 扩展并开放项目需要的调试权限也可以尝试接入。Firefox 和 Safari 使用不同的扩展接口目前不在支持范围内。EasyBR 是一个可选的兼容场景。每个多开环境仍保留自己的 Cookie、Local Storage 和登录状态Easy WebBridge 会把它们识别为不同的浏览器目标。操作多账号前仍然需要先核对账号和browserId。从零开始怎么安装项目需要 Node.js 20 和一个 Chromium 内核浏览器。先克隆仓库并启动本机 Bridgegitclone https://github.com/xxjrq/easy-webbridge.gitcdeasy-webbridgenpminstallnodecli/easy-webbridge.mjs start然后打开目标浏览器的扩展管理页进入chrome://extensions。开启“开发者模式”。点击“加载未打包的扩展程序”。选择仓库中的extension/目录。扩展显示已连接后查看当前在线环境。nodecli/easy-webbridge.mjs list同一个本机运行时可以同时提供 CLI、HTTP API 和 Agent Skill。Codex、Claude Code、OpenCode、WorkBuddy、OpenClaw、Cursor 等工具都可以按自己的接入方式调用它。已登录浏览器会不会丢登录态Easy WebBridge 复用的是当前浏览器 Profile。只要网站登录没有过期用户没有退出账号也没有清除 CookieAgent 看到的就是那个浏览器里的已登录页面。这不等于登录状态永远有效。平台仍可能要求重新登录、二次验证或验证码。Easy WebBridge 不会绕过这些机制也不会把“复用当前登录态”宣传成免登录。安全边界不能省Easy WebBridge 拥有完整的浏览器控制能力可以读取登录后的页面、操作标签页、上传和下载文件也能使用浏览器调试接口。因此它只应该安装在你愿意授权给 Agent 的浏览器环境里。Bridge 默认只监听本机请求需要本地 Token每条命令还必须指向明确的browserId。这些设计可以降低误操作风险但不能替代用户自己的权限管理。它不会绕过验证码、访问控制、平台审核或其他安全验证。发布、发送、付款、删除、修改账号安全设置等动作会产生真实后果应该保留当次确认。我的原则很简单重复劳动可以交给 Agent最终责任仍然留在人手里。这个项目适合谁如果你经常在已登录的网页后台工作希望把页面读取、资料整理、表单填写、截图和上传准备交给 AgentEasy WebBridge 值得试试。如果你的目标是做完全隔离、无状态、可重复的自动化测试Playwright 或 Selenium 可能更合适。如果你的任务不允许 Agent 接触真实账号也不应该把对应浏览器接入 Bridge。Easy WebBridge 采用 MIT 许可证。项目还在持续完善如果你也碰到过“脚本能打开网页却接不上我当前已经登录的页面”欢迎到 GitHub 看看代码、提 Issue或者告诉我你实际遇到的浏览器场景。项目地址https://github.com/xxjrq/easy-webbridge