🌤️ 想跳过配置?使用我们的 云服务,获得更快、可扩展且支持隐身模式的浏览器自动化体验!
1. 创建环境并使用 uv 安装 Browser-Use (Python>=3.11):
uv init && uv add browser-use && uv sync
# uvx browser-use install # 如果没有安装 Chromium 则运行此命令
2. [可选] 从 Browser Use Cloud 获取你的 API 密钥 (新注册用户可获得 $10 免费额度):
# .env
BROWSER_USE_API_KEY=你的密钥
# GOOGLE_API_KEY=你的密钥
# ANTHROPIC_API_KEY=你的密钥
3. 运行你的第一个智能体:
from browser_use import Agent, Browser, ChatBrowserUse
# from browser_use import ChatGoogle # ChatGoogle(model='gemini-3-flash-preview')
# from browser_use import ChatAnthropic # ChatAnthropic(model='claude-sonnet-4-6')
import asyncio
async def main():
browser = Browser(
# use_cloud=True, # 在 Browser Use Cloud 上使用隐身浏览器
)
agent = Agent(
task="查找 browser-use 仓库的星标数量",
llm=ChatBrowserUse(),
# llm=ChatGoogle(model='gemini-3-flash-preview'),
# llm=ChatAnthropic(model='claude-sonnet-4-6'),
browser=browser,
)
await agent.run()
if __name__ == "__main__":
asyncio.run(main())
https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850
https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06
想更快开始? 生成一个可直接运行的模板:
uvx browser-use init --template default
这将创建一个包含工作示例的 browser_use_default.py 文件。可用模板:
- default - 快速入门的最小化设置
- advanced - 包含详细注释的所有配置选项
- tools - 自定义工具和扩展智能体的示例
你也可以指定自定义输出路径:
uvx browser-use init --template default --output my_agent.py
通过命令行进行快速、持久的浏览器自动化:
browser-use open https://example.com # 导航到 URL
browser-use state # 查看可点击元素
browser-use click 5 # 按索引点击元素
browser-use type "Hello" # 输入文本
browser-use screenshot page.png # 截图
browser-use close # 关闭浏览器
CLI 会在命令之间保持浏览器运行,以便快速迭代。查看 CLI 文档 了解所有命令。
对于 Claude Code,安装该技能以启用 AI 辅助的浏览器自动化:
mkdir -p ~/.claude/skills/browser-use
curl -o ~/.claude/skills/browser-use/SKILL.md \
https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md
from browser_use import Tools
tools = Tools()
@tools.action(description='描述此工具的功能。')
def custom_tool(param: str) -> str:
return f"结果: {param}"
agent = Agent(
task="你的任务",
llm=llm,
browser=browser,
tools=tools,
)