教程 · 浏览器自动化 · browser-use

browser-use 教程

按官方 Human Quickstart：uv 安装、.env 放 Key、跑 Show HN。本机已 uv pip install browser-use；没有模型 Key，Agent.run 未代跑。

按官方 Human Quickstart 走一遍。跑通标准：本机弹出浏览器，Agent 能完成一句自然语言任务。跑任务需要你自己的模型 Key，本教程不代填、不写入仓库。

本机已在隔离 venv 里执行 uv pip install browser-use，包装上了。没有 BROWSER_USE_API_KEY / OPENAI_API_KEY 等环境变量，所以没有执行 agent.run()。

1. 安装

官方文档逐步是：

pip install uv
uv venv --python 3.12
source .venv/bin/activate
uv pip install browser-use
uvx browser-use install

README 也可以 uv add browser-use（Python ≥ 3.11）。本机安装日志节选：

2. 写 .env

在项目目录：

touch .env

用编辑器打开 .env，按官方加一行（不要提交 git）：

BROWSER_USE_API_KEY=

Key 从 https://cloud.browser-use.com/new-api-key 申请。也可以改用 GOOGLE_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY（见 Quickstart 各家示例）。

官方 Human Quickstart：Install / .env / first agent

3. 跑通一次

官方示例任务：Find the number 1 post on Show HN。把下面存成 run.py 再 python run.py：

from browser_use import Agent, ChatBrowserUse
from dotenv import load_dotenv
import asyncio

load_dotenv()

async def main():
    llm = ChatBrowserUse()
    task = "Find the number 1 post on Show HN"
    agent = Agent(task=task, llm=llm)
    await agent.run()

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

没有 Browser Use Key 时，按文档改用 ChatOpenAI / ChatAnthropic / ChatGoogle 和对应环境变量。本机缺 Key，这一步请你在填好 .env 后自己跑。