10 分钟跑通 AI 浏览器自动化:ego-lite 让你和 AI Agent 共用同一个浏览器
【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite
如果你在用 Claude Code 或 Codex 跑浏览器任务,多半见过这个场面:Agent 打开你正在用的浏览器,动了你的标签页,还卡在登录墙上。ego-lite 是一款面向 AI 浏览器自动化的 Chromium 浏览器,让你和多个 Agent 在同一个浏览器里并行工作,免费、零配置。读完本文,你能完成安装、跑通第一个任务,并判断它适不适合你的工作流。
痛点:现有浏览器自动化方案为什么总在抢你的浏览器
让 Agent 去 X 上批量看竞品账号的帖子,结果它打开的是你正在用的浏览器——标签页被翻动、鼠标自己移动,两分钟后弹出二维码让你扫码登录。这不是个案,而是当前两类方案的结构性问题:
| 现有方案 | 痛点 | ego-lite 的做法 |
|---|---|---|
| 自动化框架(browser-use、playwright 类) | 只是"桥",要另配浏览器;登录状态带不走;和 AI 抢同一个标签页 | 它本身就是浏览器,直接继承你的登录态 |
| 内置助手的 AI 浏览器 | 只能被内置 Agent 驱动,接不进你正在用的 AI 工具 | 任意 Agent(Claude Code、Codex、Cursor、自研)都能驱动 |
核心思路一句话:给 AI 单独开工位,而不是把你的工位让出去。你正常浏览,Agent 在各自的隔离空间里干活,互不打扰。
快速上手:从安装到第一个任务的三步流程
平台支持:macOS(Apple Silicon / Intel)、Windows;Linux 在路线图上。浏览器本体是独立的免费应用,本仓库开源的是 Node.js 运行时 + Agent 技能包。
第 1 步:安装(三选一)
从官网下载安装包打开即装;或者只装 Agent 技能包:
npx skills add citrolabs/ego-lite也可以把任务直接丢给 Agent,让它按 references/install.md 的步骤自己装(macOS 脚本在 scripts/install.sh)。
第 2 步:完成首次引导
首次启动只问一个问题:是否迁移你的 Chrome 数据?选"是",Agent 就继承你现有的登录、Cookie、扩展和书签。浏览数据全部留在你的设备上,遥测只记录"是否设为默认浏览器"这类产品信号。
第 3 步:跑第一个任务
在 Agent 终端输入/ego-browser加空格,然后用大白话描述需求:
ego-browser follow @ego_agent on x.com for meAgent 加载ego-browser技能后,在自己的 Space 里打开页面、读取快照、执行操作、汇报结果,全程不碰你的标签页。想浏览源码时:git clone https://gitcode.com/GitHub_Trending/eg/ego-lite。
能力拆解:ego-lite 能帮你做哪四类事
代码驱动,把多步任务写成一段 JS
其他工具让 Agent 走"调一个命令 → 看结果 → 再调一个命令"的循环,ego-lite 把能力封装成注入脚本范围的 JavaScript 函数(snapshot、fill、click、wait……),Agent 写一段代码一次执行完:
ego-browser nodejs <<'EOF' const task = await taskSpace("inspect example page"); await task.page("p1").goto("https://example.com"); console.log(await page.snapshot()); EOF同样的模型、同样的 Agent,4 个真实任务各跑 5 次取中位数:
- 抓取 OpenAI 热门文章:87s vs 226s,快 2.6 倍,成本 $0.21 vs $0.42,便宜一半;
- LinkedIn 求职申请:快 1.9 倍、便宜 1.4 倍;
- 房贷计算:快 1.4 倍;Expedia 订票:166s 完成,agent-browser 直接被 bot 检测拦截;
- 在 31 个任务的 Real-World Bench 上,ego-browser 比其他工具快 47%~63%。
任务越复杂,差距越明显。
每个 Agent 一个独立 Space
每个 Space 是隔离的浏览空间:你能随时看到哪个 Space 在跑任务,随时接管或停止。多个 Agent 可以并行——Claude Code 在 10 个 Space 里处理 10 条线索,Codex 在另外 5 个 Space 里抓竞品网站,你的鼠标纹丝不动。
内核级定制的页面 Snapshot
纯文本模型靠 Snapshot"看见"网页,质量直接决定成败。得益于浏览器内核层面的定制,ego-lite 的快照能稳定处理深嵌套 iframe这类其他方案经常翻车的场景,配合元素解析器把@N引用、CSS、XPath 统一解析为页面元素。
站点经验包,越用越快
learnings/目录按站点存放经验包(X/Twitter、Google、X 已有示例):manifest.json声明可复用工具,notes/记录页面结构,tools/与browser-tools/是可直接调用的提取脚本。官方 Skill 会把每次成功操作蒸馏成这些工具,官方口径是同类任务最高提速 5 倍(即将上线)。
工作机制:从一段 JS 到页面动作的数据流
一次执行就是一条直线:Agent 把 JavaScript 传给 stdin →runMain()注入辅助函数 → 通过CDP(Chrome DevTools Protocol)直连浏览器——不经过 Puppeteer / Playwright,链路更短 → 页面快照与元素解析 → 可选的站点工具 → 结果输出。
关键模块:
| 模块 | 职责 |
|---|---|
| src/index.ts | 入口:可作为 CLI 运行,也可被浏览器应用内嵌 |
| src/helpers.ts | Agent 可调用的全部辅助函数,唯一的"说明书" |
| src/browser-runtime.ts | CDP 传输、会话缓存与事件队列 |
| src/element-resolver.ts | 把@N引用、CSS、XPath 统一解析为页面元素 |
| src/driver/ | 导航、点击、键盘、截图、等待、文件上传等驱动 |
注意仓库里是"驾驶系统"不是"发动机":浏览器本体是独立的免费应用,本仓库提供运行时和技能包(TypeScript / Node 22+)。
Task Space 是这套机制的底座:独立标签页、继承你的登录状态、带agent/user所有权模型。遇到登录或验证码时,Agent 通过task.handOff()把浏览器交还给你,你说"继续"它再接管。
适用场景:谁现在就该用,谁可以等一等
- 📝网页数据抓取:提取 X 时间线、Google 搜索结果,登录态直接绕开"未登录墙";
- 📄表单批量填写:LinkedIn 投递、注册流程、问卷,真实账号操作不易被拦;
- 🎫预订与抢购:Expedia 订票这类 benchmark 中被检测拦截的场景,它完成了;
- 🧑💼并行业务流:多 Agent 同时处理线索、监控竞品,你的标签页不受影响;
- 🧪Web 应用测试:SKILL.md 把探索性测试、QA、Bug 挖掘列为正式用途;
- 🌐日常浏览:装好就是一个正常的浏览器,日常照用。
现在就该用:macOS / Windows 用户,日常在用 Claude Code 或 Codex,且有"需要带着登录态干活"的场景。可以等:Linux 用户(路线图上),或只需要一次性无头脚本的人——它是个 GUI 浏览器,不是 headless 服务。
上手路线:按需求找文档
| 想做什么 | 看哪里 |
|---|---|
| 了解 Agent 完整用法 | skills/ego-browser/SKILL.md |
| 查 API 与脚本规范 | package/ego-browser/skill-body/SKILL.md |
| 解决安装 / 连接问题 | references/install.md |
| 研究架构、贡献代码 | AGENTS.md、CONTRIBUTING.md |
| 看站点经验包示例 | learnings/x-com/manifest.json |
| 本地运行时开发调试 | docs/local-runtime-development.md |
ego-lite 把"AI 抢你的浏览器"变成了"你和 AI 共享一个浏览器"——免费、MIT 协议、零配置,装好之后,浏览器活交给 Agent,鼠标还留在你手上。
【免费下载链接】ego-liteThe fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.项目地址: https://gitcode.com/GitHub_Trending/eg/ego-lite
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考