Browser-Use笔记2:安装与测试

1. 安装 Browser-Use

# 使用 pip 安装
python -m pip install browser-use

# 验证安装
python -m pip list | findstr browser-use

安装输出示例:

Successfully installed browser-use-0.10.1 ...

2. 安装 Chromium 浏览器

Browser-Use 需要 Chromium 浏览器来执行自动化任务。

# 安装 playwright(用于下载 Chromium)
python -m pip install playwright

# 下载 Chromium 浏览器
python -m playwright install chromium

预期输出:

Downloading Chromium 143.0.7499.4 ...
Chromium downloaded to ...

3. 创建测试脚本

创建文件 test_gemini_local.py

import asyncio

from browser_use import Agent, ChatOpenAI
from browser_use.browser.profile import BrowserProfile, ProxySettings

async def main():
    # 1. 配置 LLM(使用本地 Gemini 代理)
    llm = ChatOpenAI(
        model="gemini-3-pro-preview",
        api_key="123456",
        base_url="http://localhost:3000/gemini-antigravity/v1"
    )
    
    # 2. 配置代理设置
    proxy = ProxySettings(
        server="socks5://192.168.3.65:8898"
    )
    
    # 3. 配置浏览器
    browser_profile = BrowserProfile(
        proxy=proxy,
        user_data_dir="D:\\chromium_user_data",
        enable_default_extensions=True,  # 启用广告拦截等扩展
        headless=False  # 显示浏览器窗口
    )
    
    # 4. 创建 Agent 并执行任务
    agent = Agent(
        task="Go to github.com/browser-use/browser-use and tell me the number of stars",
        llm=llm,
        browser_profile=browser_profile,
    )
    
    result = await agent.run()
    print("\n" + "="*50)
    print("执行结果:", result)
    print("="*50)

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

4.配置参数说明

BrowserProfile 主要参数

参数 说明 默认值
proxy 代理设置(ProxySettings 对象) None
user_data_dir 浏览器用户数据目录 临时目录
enable_default_extensions 启用默认扩展(广告拦截、Cookie 处理等) True
headless 无头模式(不显示浏览器窗口) False
window_size 浏览器窗口大小 None(最大化)
disable_security 禁用安全特性 False

默认扩展功能

Browser-Use 首次运行会自动加载以下扩展(需要访问 Google, 所以需要给python进程配置代理, 不是上面的ProxySettings):

uBlock Origin - 广告拦截,加速页面加载

  1. I still don't care about cookies - 自动处理 Cookie 横幅
  2. ClearURLs - 清理 URL 跟踪参数
  3. Force Background Tab - 防止新标签页抢焦点

运行测试

基本运行

python test_gemini_local.py