我的开源项目:AI 浏览器助手 Easy WebBridge
我的开源项目:AI 浏览器助手 Easy WebBridge
这是我开源的 AI 浏览器助手 Easy WebBridge。它让 Claude Code、Codex、OpenCode、WorkBuddy 等 AI Agent 直接操作你已经打开、已经登录的真实浏览器——不新开浏览器,不重复登录,登录态继续保留在本地。它支持 Chrome、Edge、QQ 浏览器、Chromium 和 EasyBR 多开环境,提供 CLI、本机 HTTP API 和 Agent Skill 三种调用方式。

它解决什么问题
普通浏览器自动化工具(Playwright、Selenium)的默认做法是新启动一个干净的浏览器实例,然后你要自己去配 Profile、重新登录。对测试是好事,用于已登录后台时,往往还需要额外处理:
- 后台系统必须登录才能看到数据,自动化浏览器是空白会话;
- 换一个账号就要重新配置登录态;
- 多账号操作时,容易把 A 账号的动作发到 B 账号。
Easy WebBridge 走的是另一条路:连接你正在使用的浏览器。AI 看到的是你登录后的真实页面,在明确的浏览器环境中继续任务。
核心能力
| 能力 | 说明 |
|---|---|
| 复用现有登录态 | 不用启动空白浏览器,不用再次登录后台 |
| 每个浏览器独立 ID | 每个已连接环境有独立 browserId,一条命令只发给指定目标 |
| 多浏览器管理 | Chrome、Edge、QQ 浏览器、Chromium 同时连接,按 ID 区分 |
| EasyBR 多开环境 | 识别环境名称、颜色和独立 browserId,适合已授权的多账号场景 |
| Agent 调用 | 自带 CLI、本机 HTTP API 和 Skill,支持这些调用方式的 AI Agent 可按指南接入 |
| 页面深度控制 | 语义快照、DOM 读取、点击、填写、滚动、截图、导出 PDF、网络请求读取 |
技术细节:Bridge 只监听本机 127.0.0.1,请求需要本地 Token,每次命令必须指定目标 browserId。它不会修改浏览器指纹、UA、时区或代理,不加入随机人类轨迹,也不绕过 CAPTCHA 和安全验证。
支持的浏览器和 AI 工具
已实测的浏览器:Google Chrome、Microsoft Edge、QQ 浏览器、Chromium、EasyBR 指纹浏览器。其他 Chromium 内核浏览器可接入(需允许 Manifest V3 扩展和所需 CDP 权限)。Firefox 和 Safari 不支持。
可调用的 AI 工具:Claude Code、Codex、OpenCode、WorkBuddy、OpenClaw、Cursor 等,通过 Agent Skill、CLI 或本机 HTTP API 连接。
典型使用场景
1. 已登录的后台系统
Shopify、WordPress、广告后台、CMS、CRM、SaaS 管理台等,用户登录一次后让 AI 阅读、分析、填写和执行重复操作。发布、发送、付款或删除等操作,按你明确授权的对象和范围执行。
2. 网页研究与页面分析
读取真实 DOM、语义快照和当前页面状态,分析 SEO 结构、表单、内容或后台数据,再根据实际页面继续下一步。
3. 多开环境下的分账号操作
每个 EasyBR 环境保留独立 Cookie 和登录态,AI 按 browserId 在指定环境操作,便于区分任务和账号;操作前仍要确认选中的环境。
4. 应用商店后台辅助
在已登录的 App Store Connect 或 Google Play Console 中检查待补资料、版本信息、截图和表单字段,按明确授权填写或上传,具体检查、填写、上传和提交流程由对应的业务 Skill 及你的授权范围决定。
连接与授权
这是一个完整的浏览器控制能力,只应安装在愿意授权给 Agent 的浏览器环境中:
- 只监听本机地址,不对外网开放;
- 本地 Token 验证,每次命令指定目标
browserId; - 支付、发布、发送、删除、账号安全修改等后果性动作,必须取得你当次明确授权;
- 不绕过验证码、访问控制、平台审核或安全验证。
和 Playwright / Selenium 的区别
| 维度 | Easy WebBridge | 普通 Playwright / Selenium |
|---|---|---|
| 浏览器环境 | 直接用你当前的浏览器 | 通常启动独立实例 |
| 登录态 | 复用现有登录 | 常需另行配置 Profile |
| 多浏览器管理 | 按 browserId 管理已连接环境 | 通常按独立会话管理 |
| AI Agent 调用 | 自带 CLI、HTTP API、Skill | 需自行封装 |
| 适合场景 | 已登录后台、真实网页任务 | 可重复的测试与隔离自动化 |
两者不是替代关系:Playwright 擅长测试和可重复环境,Easy WebBridge 专攻"在用户现有浏览器和登录会话里继续工作"。
常见问题
问:会重新启动 Chrome 吗?
答:不会。它在安装了扩展并已连接 Bridge 的现有浏览器环境中工作。
问:可以用已经登录的网站吗?
答:可以。只要该浏览器 Profile 的登录没有过期,Agent 看到的就是对应账号的已登录页面。
问:AI 会自动发布、付款或删数据吗?
答:这些动作需要明确授权。你可以只让它检查或保存草稿,也可以授权它完成指定内容的发布;实际执行还取决于业务 Skill 和平台当前状态。
问:支持哪些系统?
答:macOS(Apple 芯片)和 Windows 推荐通过 EasyBR 使用(已内置 Bridge);其他系统可用源码方式运行本地 Bridge,需要 Node.js 20+。
问:是开源的吗?
答:是,采用 MIT 许可证。GitHub 仓库名为 aiispower/easy-webbridge,Gitee 备用镜像为 xxjrq/easy-webbridge。
资料来源
- GitHub 开源仓库:aiispower/easy-webbridge(含完整 README、HTTP API 与命令参考、安全说明)
- EasyBR 官网(EasyBR 已内置 Easy WebBridge)
更多推荐

所有评论(0)