Agent/examples

Browser-Use 云浏览器模式示例

本目录包含 Browser-Use 云浏览器模式的完整示例和文档。

📁 文件说明

• cloud_browser_example.py - 云浏览器模式示例代码（包含 5 个示例）
• CLOUD_BROWSER_GUIDE.md - 详细使用文档

🚀 快速开始

1. 安装依赖

pip install python-socks

2. 配置环境变量

在项目根目录的 .env 文件中添加：

BROWSER_USE_API_KEY=your_api_key_here

3. 运行示例

# 运行默认示例（示例 1: 基础导航操作）
python examples/cloud_browser_example.py

# 运行指定示例
python examples/cloud_browser_example.py --example 2

# 运行所有示例
python examples/cloud_browser_example.py --all

📚 示例列表

1. 基础导航操作 - 访问网页、获取页面信息、截图
2. 搜索和内容提取 - 使用搜索引擎、提取页面内容
3. 使用 BrowserProfile - 预设 cookies、localStorage、User-Agent
4. 表单交互 - 填写表单、提交数据
5. 多标签页操作 - 管理多个标签页

📖 详细文档

查看 CLOUD_BROWSER_GUIDE.md 获取完整的使用指南，包括：

• 云浏览器 vs 本地浏览器对比
• 环境配置详解
• 核心概念和 API 说明
• 完整示例代码
• 高级用法
• 常见问题解答
• 最佳实践

🔑 核心代码

import asyncio
from dotenv import load_dotenv
from agent.tools.builtin.baseClass import (
    init_browser_session,
    cleanup_browser_session,
    navigate_to_url,
)

load_dotenv()

async def main():
    # 初始化云浏览器
    browser, tools = await init_browser_session(
        headless=True,
        use_cloud=True,  # 关键：启用云浏览器
    )

    # 访问网页
    await navigate_to_url("https://www.baidu.com")

    # 清理
    await cleanup_browser_session()

asyncio.run(main())

🌟 云浏览器优势

• ✅ 无需本地安装 Chrome/Chromium
• ✅ 可在无头服务器上运行
• ✅ 提供 Live URL 实时查看
• ✅ 更好的稳定性和性能
• ✅ 支持分布式部署

🛠️ 技术支持

• 详细文档: CLOUD_BROWSER_GUIDE.md
• 基础类源码: agent/tools/builtin/baseClass.py
• Browser-Use 官方文档: https://docs.browser-use.com

📝 注意事项

1. 确保已安装 python-socks 依赖
2. 确保 .env 文件中配置了有效的 BROWSER_USE_API_KEY
3. 云浏览器需要网络连接，可能有轻微延迟
4. 使用 Live URL 可以实时查看云浏览器操作

---

更新时间: 2026-01-30