browser-use

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

像人类一样浏览网页。

查找可用时段，选择日期和时间，处理验证码，并预约驾驶考试。

探索更多演示和提示 ↗

AI代理和爬虫: 阅读 browser-use.com/llms.txt 获取产品地图（开源、浏览器控制、云浏览器、代理API、定价）以及 docs.browser-use.com/llms.txt 获取文档索引。Browser Use 是开源浏览器代理（Python 和 TypeScript），提供每浏览器小时 $0.02 的云浏览器，并具备隐身、验证码解决和住宅代理功能，同时提供托管的代理API。

我需要哪种 Browser Use？

• 路径1：完全托管的云: 使用完全托管的代理和浏览器进行扩展。
• 路径2：CLI: 自动化您自己的浏览器任务。
• 路径3：Python库: 从自己的代码本地运行开源 Browser Use 代理。

快速开始

路径 1：完全托管的云

通过我们的托管代理、隐身浏览器以及用于配置文件、录制和数据策略的基础设施来扩展浏览器自动化。

开始使用 API ↗

新的 Google、GitHub 或 Microsoft 注册用户可获得 15 美元云信用。

路径 2：命令行界面（CLI）

将此提示粘贴到Claude Code、Codex、Hermes、OpenClaw或你喜欢的任何代理中。

Install or upgrade browser-use to the latest stable version with uv using Python 3.12, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md.

路径 3：Python 库

从 Python 本地运行 Browser Use 代理，可选择模型和本地或云浏览器：

1. 安装 Browser Use（Python >= 3.11）：

安装 uv 后，如果你是开始一个新项目，请先运行 uv init --python 3.12。

uv add browser-use

2. 将你的 OpenAI API 密钥 添加到 .env：

# .env
OPENAI_API_KEY=your-key
# BROWSER_USE_API_KEY=your-key  # Optional: BU2 model or cloud browser

对于任意可选的浏览器使用服务，请获取一个 浏览器使用 API 密钥。

3. 将此保存为 agent.py：

import asyncio

from browser_use import Agent, Browser, ChatBrowserUse, ChatOpenAI
from dotenv import load_dotenv

load_dotenv()

async def main():
    llm = ChatOpenAI(model='gpt-5.6-luna', reasoning_effort='xhigh')
    # llm = ChatBrowserUse(model='bu-2-0')  # Use BU2 instead; requires BROWSER_USE_API_KEY
    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=llm,
        # browser=Browser(use_cloud=True),  # Use a cloud browser; requires BROWSER_USE_API_KEY
    )
    history = await agent.run()
    print(history.final_result())

if __name__ == "__main__":
    asyncio.run(main())

要使用 BU2，请将 ChatOpenAI 行替换为已注释的 ChatBrowserUse 行。云浏览器选项适用于任一模型。

4. 运行它：

uv run agent.py

代理打开浏览器，查找仓库，并打印其答案。

Python 库文档 ↗

浏览器使用基准测试 v2

这个非常困难的基准测试针对最难的浏览器任务。在较简单的任务中，即使是较小的模型也能取得非常高的成功率。显示的结果来自 BU Bench V2 的 60 个任务子集。

在我们的文档中了解集成、托管、自定义工具、MCP 等 ↗

常见问题

从 browser_use 导入 Agent, ChatBrowserUse

llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6')  # 或 'google/gemini-3-pro'
agent = Agent(task='...', llm=llm)

import asyncio
from datetime import datetime, timezone

从 browser_use 导入 ActionResult、Agent、ChatBrowserUse、Tools 从 dotenv 导入 load_dotenv

加载_dotenv()
tools = Tools()

@tools.action(description='获取当前UTC日期和时间。')
def 获取当前时间() - >  动作结果:
    return ActionResult(extracted_content=datetime.now(timezone.utc).isoformat())

异步 def main():
    agent = Agent(
        task="What is the current UTC time?",
        llm=ChatBrowserUse(model='bu-2-0'),
        tools=tools,
    )
    history = await agent.run()
    print(history.final_result())

if __name__ == "__main__":
    asyncio.run(main())

相关仓库

引用

如果您在研究或项目中使用浏览器使用，请引用：

@software{browser_use2024,
  author = {Müller, Magnus and Žunič, Gregor},
  title = {Browser Use: Enable AI to control your browser},
  year = {2024},
  publisher = {GitHub},
  url = {https://github.com/browser-use/browser-use}
}