我的开源项目:AI 浏览器助手 Easy WebBridge

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

Easy WebBridge 浏览器连接场景示意

它解决什么问题

普通浏览器自动化工具(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)
Logo

更多推荐