browser-use 浏览器自动化库源码

源码简介

这套源码是 AI 浏览器自动化方向的 Python 库，主要让大语言模型驱动浏览器完成开页、点击、输入、填表与数据抓取。
项目由 Browser Use 团队维护，版本 0.13.4，采用 MIT 协议，要求 Python 3.11 及以上，属于纯库加命令行形态，没有独立后台与数据库。
从代码结构看，agent、controller、dom、llm、tools、mcp 等模块分工清晰，是学习智能体网页操作与自动化流程的优质参考。
源码免费提供，适合本地部署测试、阅读核心实现与做二次开发。

适用场景

• 学习 AI Agent 如何驱动真实浏览器完成网页任务
• 搭建自动填表、比价、信息抓取等 RPA 自动化流程
• 二次开发自定义动作、接入私有 LLM 或 MCP 服务

技术栈与运行环境

• 前端：无独立前端，浏览器由 Playwright 驱动并渲染
• 后端：Python 异步（asyncio），核心为 Agent、Controller、DOM 模块
• 数据库：无，运行态状态保存在内存与历史对象中
• 运行环境：Python 3.11 及以上，需安装 Playwright 浏览器运行时
• 其他依赖：pydantic、httpx、aiohttp、mcp、openai/anthropic 等 LLM SDK、posthog 遥测

功能亮点

• Agent 任务循环：agent/service.py 的 Agent 类包含 step、run、run_sync 方法，支持任务分解、历史回溯与思考模式，是整套自动化的调度核心。
• 动作注册表与控制器：tools/service.py 的 Controller 用 @registry.action 注册内置动作，如返回、等待、滚动到文本、点击与输入，并支持自定义动作扩展。
• 浏览器与 DOM 序列化：基于 Playwright 的 BrowserSession 与 BrowserProfile，dom 模块把页面转成精简 DOM 树与 Markdown 供模型读取，降低上下文开销。
• 多 LLM 接入：llm 目录覆盖 OpenAI、Anthropic、Google、DeepSeek、Ollama、Azure 等近 20 家，README 以 ChatBrowserUse 或 ChatOpenAI 等方式调用。
• MCP 集成：mcp 模块提供 BrowserUseServer 与 CLI MCP server，可作为工具服务被其它智能体通过 MCP 协议调用。
• 命令行与云端：console_scripts 注册 browser-use 命令与 browser-use-init 初始化，browser/cloud 支持云端浏览器与 Gmail 等扩展集成。

安装与部署提示

1. 要求 Python 3.11 及以上，建议用 uv：`uv add browser-use` 或 `pip install browser-use`。
2. 安装 Playwright 浏览器运行时：`playwright install chromium`（首次运行会下载浏览器）。
3. 配置 .env 文件，填入对应 LLM API Key，例如 OPENAI_API_KEY、ANTHROPIC_API_KEY 或 BROWSER_USE_API_KEY。
4. 运行入口：Python 中 `from browser_use import Agent, ChatBrowserUse`，写好 task 与 llm 后 `await agent.run()`；也可命令行执行 `browser-use` 或 `browser-use skill install`。
5. 属库加 CLI 形态，无数据库与后台，按包内 README 与 examples 目录的示例部署即可。

常见问题

#### 运行前需要注意什么？

Python 需 3.11 及以上，先装好 Playwright 浏览器与对应 LLM API Key。
首次运行会自动下载浏览器运行时，建议在能访问外网的环境执行。

#### 适合二次开发吗？

适合。
模块划分清晰，Controller 支持自定义 action，llm 目录便于接入私有模型，mcp 模块方便对外暴露能力，是较好的智能体自动化学习蓝本。

安全风险提示

特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！

下载说明

源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本工具具备真实浏览器操作能力，请仅用于你有权限的站点与合规场景，遵守目标站 robots.txt 与服务条款，不得用于未授权抓取、账号冒用或违反平台规则的行为。