Skill/流程自动化/Browser Use
流程自动化 119.6k 仓库 Star

Browser Use

连接浏览器完成任务

本项通过命令行连接本地或云端浏览器,为现有 Agent 提供页面读取、点击输入、信息提取与结果核对的操作流程。适合需要交互、动态渲染或已有登录状态的网页任务;连接、账号和服务必须另行准备,自主 Agent 库与托管服务各有运行条件。

你需要准备:任务目标、目标网站及必要账号授权

一桉AI 整理 · 2026.11.01 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Browser Use 能帮你做什么?

  • 建立合适的浏览器连接

    按任务使用本地 Chrome 或已授权云浏览器,检查连接状态,并复用合适标签页保持任务上下文。

  • 处理连续页面任务

    通过页面结构与必要截图判断下一步,执行导航、填写与信息提取,并验证操作后的页面状态。

  • 管理任务的浏览器范围

    区分本地共享浏览器与隔离云浏览器,安排标签页和并行任务,避免多个操作互相干扰。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 整理已登录后台资料

    例如在获准访问的后台筛选记录、读取页面信息并整理结果,不假定公开网页抓取就能取到数据。

  • 核对动态网站流程

    例如操作需要脚本渲染的页面,比较点击前后状态,记录可重复的步骤与实际反馈。

怎么开始使用?

从材料到结果流程示意,非实测结果

网站与任务目标

准备这些材料多步骤浏览器任务

任务目标、目标网站及必要账号授权

经过验证的网页结果

  1. 01

    连接可用浏览器

  2. 02

    逐步执行网页任务

  3. 03

    核对并整理结果

准备什么,会得到什么?

准备的材料
任务目标、目标网站及必要账号授权
交付的结果
  • 从指定网页取得并整理的信息,或已执行步骤与结果记录。
  • 必要的页面证据,以及登录、连接或网站限制说明。

使用前要知道

现役命令与生成的 Skill 名称为 browser-harness,需要完整 CLI、Python/uv 环境和 workspace 资源。实际网页操作还需可用且获准的浏览器连接;云服务认证与费用另计。不能把一份安装好的 SKILL.md 当成浏览器已经连接。

常见问题

使用本地浏览器也需要云 API Key 吗?

本地 Chrome 连接不强制使用 Browser Use Cloud Key。云端浏览器、托管 Agent 和模型调用分别有各自的认证与费用。

多位 Agent 能同时操作同一浏览器吗?

本地控制器共享当前标签页状态,同时切换和输入容易互相干扰。可把网页操作排成顺序,确需隔离并行时再使用独立浏览器环境。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • browser-use · SKILL.md ↗2026-10-31 核对
  • Browser Use · CLI 与浏览器连接说明 ↗2026-10-31 核对
  • Browser Harness 当前安装、生成名称与连接说明 ↗2026-11-01 核对
来源与使用条件
原始项目
browser-use/browser-use ↗
Skill 名称
browser-use
Skill 目录
browser_use/skills/browser-use
仓库 Star
119,632 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
以原项目许可为准
使用条件
当前现役安装路线使用 Python 3.12、uv 和 browser-harness CLI,再由 browser-harness skill 生成名为 browser-harness 的 Skill;原 Browser Use 仓库仍保留 browser-use 源文件。实际操作还需 Chrome/CDP 或另行授权的云浏览器连接。
注意事项
MIT 许可。本项保留 Browser Use 原始来源;当前官方连接指南已转向 Browser Harness,安装后以生成文件的 frontmatter name 为准,通常为 browser-harness。仅复制旧 SKILL.md 不能视为已具备浏览器能力。本地 Chrome 不强制云 API Key;云端服务认证与费用另计,未在本站安装或运行验证。
查看安装与使用提示词
请帮我准备并使用 Browser Use Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/browser-use/browser-use
所选目录:browser_use/skills/browser-use
参考分支:main
原始目录 frontmatter name:browser-use
安装后的目标调用名:browser-harness
来源页面:https://github.com/browser-use/browser-use/tree/main/browser_use/skills/browser-use
安装路线核对日期:2026-11-01
browser-use:当前源 SKILL.md:https://github.com/browser-use/browser-use/blob/main/browser_use/skills/browser-use/SKILL.md
browser-use/browser-use:当前安装说明:https://github.com/browser-use/browser-use/blob/main/README.md
Browser Harness:现役 Codex 路线:https://github.com/browser-use/browser-harness/blob/main/README.md
Browser Harness:当前安装与连接指南:https://github.com/browser-use/browser-harness/blob/main/install.md
生成路线的实际 Skill:name=browser-harness:https://github.com/browser-use/browser-harness/blob/main/SKILL.md
OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是 CLI 安装路线。先检查已安装的 CLI 和运行环境,再按下列项目文档为 Codex 生成所需文件;不要把仓库的源文件目录直接当作生成后的 Skill。

所选 Skill 的具体安装步骤:
1. 本条目录仍展示 Browser Use 原始来源,原始 frontmatter name=browser-use;先读当前 browser-harness 官方安装指南,明确现役生成的 Skill 名称为 browser-harness,不沿用旧 browser-use skill install 当作已验证路线。
2. 先检查 uv、Python 3.12 和 browser-harness 是否已有,再根据实际授权安装/升级 browser-harness。上游示例 uv tool install --python 3.12 --upgrade --force browser-harness 会替换同工具旧版,应先检查既有版本与配置,不盲目照抄 --force。
3. 由 browser-harness skill 输出当前完整 Skill 正文,确认其 frontmatter name=browser-harness,再保存到 <项目根目录>/.agents/skills/browser-harness/SKILL.md;上游示例用旧 .codex/skills,本指导按当前 Codex 官方发现目录调整。CLI、workspace 和运行资源必须保留,不能只复制静态旧 browser-use 文件。
4. 若已有同名或旧 browser-use/browser 目录,先报告来源与冲突;不要自动删除用户旧目录,也不修改 bundled/vendor 插件缓存。Codex 自动检测目录变更,仍未出现才新聊天/重载。
5. 浏览器连接属于实际使用步骤,需用户指定本地 Chrome/CDP 或已获准云环境后再配置;安装检查不打开或登录浏览器。录制默认不启用,保留用户既有偏好;云端认证和费用另行确认。

必须保留的资源:
- browser-harness CLI 及其 Python/uv 工具环境
- browser-harness skill 实际生成的 browser-harness/SKILL.md
- Browser Harness workspace($BH_AGENT_WORKSPACE/agent_helpers.py;启用站点 Skills 时还有 domain-skills/)与运行状态目录
- 需要时读取官方 interaction-skills/(连接、下载、iframe、截图等);不能用原 browser-use 静态目录替代现役运行时

已知依赖:当前现役安装路线使用 Python 3.12、uv 和 browser-harness CLI,再由 browser-harness skill 生成名为 browser-harness 的 Skill;原 Browser Use 仓库仍保留 browser-use 源文件。实际操作还需 Chrome/CDP 或另行授权的云浏览器连接。
原项目许可:以原项目许可文件为准
特别条件:MIT 许可。本项保留 Browser Use 原始来源;当前官方连接指南已转向 Browser Harness,安装后以生成文件的 frontmatter name 为准,通常为 browser-harness。仅复制旧 SKILL.md 不能视为已具备浏览器能力。本地 Chrome 不强制云 API Key;云端服务认证与费用另计,未在本站安装或运行验证。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 只检查 uv/所选 Python 与 browser-harness 命令存在、生成 SKILL.md 的真实 name 及其完整内容;不执行 page_info() 来声称被动检查。
2. 有明确已存在 daemon 且确需状态检查时用 browser-harness doctor --json --require-existing-daemon;保持原 BU_NAME(若有),缺少 daemon 就报告未连接,不启动/发现新 Chrome。
3. 不要把 browser-harness --doctor 当作纯被动检查,它可能启动或发现浏览器;不要用连接成功、录制或打开登录站点作为 Skill 下载验收。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $browser-harness;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 实际使用时显式选择 $browser-harness,或先读取本次生成文件并按其中真实 name 调用;不要默认 $browser-use 已安装可用。
- 提供任务页面、操作范围和允许使用的浏览器连接;本地 Chrome/CDP 需允许远程调试,云端环境要独立授权。只读公开内容能通过 HTTP 获取时不必控制已登录浏览器。
- 普通任务复用默认或已明确指定的 daemon,保持 BU_NAME 一致;需要隔离并行时明确独立环境,避免多代理争抢同一标签页。

我想完成的任务:
根据我提供的目标执行多步骤网页任务。先阅读官方 CLI 安装说明,检查 Python、CLI、Skill 注册和浏览器连接,在当前 Codex 允许的接口中操作。仅抓取公开文本即可完成的部分优先使用读取工具;需要交互时观察真实页面、逐步验证。账号、提交及云服务使用遵循我的明确授权。

需要我提供的材料:
任务目标、目标网站及必要账号授权

期望得到:
真实提取的网页信息、清楚的操作记录及可核对结果。准确区分本地浏览器与云浏览器,说明未完成的授权或连接步骤,不保证任意网站都可自动化。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Playwright CLI网页操作与验证
  • n8n Loops批次与分页流程
  • n8n Data Tables工作流状态表

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。