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 - 广告拦截,加速页面加载
- I still don't care about cookies - 自动处理 Cookie 横幅
- ClearURLs - 清理 URL 跟踪参数
- Force Background Tab - 防止新标签页抢焦点
运行测试
基本运行
python test_gemini_local.py