Browser-Use 自动下载让浏览器替你下载、保存、回报文件【免费下载链接】browser-use Make websites accessible for AI agents. Automate tasks online with ease.项目地址: https://gitcode.com/GitHub_Trending/br/browser-use你只需要给 Agent 一句自然语言任务Browser-Use 自动下载能力就会接管整个流程识别可下载的链接、把文件保存到你指定的目录并在下载完成后回报文件名与大小。整个过程无需人工盯着浏览器也无需自己写点击和等待逻辑。先看效果脚本跑起来后Agent 会自己打开目标网站、找到下载入口并点击文件直接落盘到你配置的目录不需要你切换窗口或手动另存为。下载结束后的日志大致如下[DownloadsWatchdog] ⬇️ 开始下载 document-sample.doc [DownloadsWatchdog] ✅ 下载完成: document-sample.doc (250 KB) FileDownloadedEvent: path~/Downloads/auto_downloads/document-sample.doc原理一句话监控DownloadsWatchdog 监听浏览器的下载信号事件下载完成时广播 FileDownloadedEvent处理你订阅该事件执行后续处理复制即跑先装好依赖并配好模型环境变量运行前只需一句pip install browser-use export GOOGLE_API_KEY你的密钥。import asyncio, os from browser_use import Agent, Browser, ChatGoogle # 指定自动保存路径这是整个下载自动化最关键的配置 browser Browser(downloads_path~/Downloads/auto_downloads) async def main(): agent Agent( task打开 https://file-examples.com/ 下载最小的 DOC 文件, llmChatGoogle(modelgemini-2.5-flash, api_keyos.getenv(GOOGLE_API_KEY)), browserbrowser, ) await agent.run(max_steps20) asyncio.run(main())三行关键逻辑downloads_path决定文件自动保存到哪里task用一句自然语言描述要下载什么Agent 负责点击和等待max_steps控制最多执行多少步防止任务失控。参数速查表配置项作用示例值downloads_path文件自动保存的目录~/Downloads/auto_downloadsauto_download_pdfs导航到 PDF 页面时是否自动存为文件Trueheadless是否无界面运行适合服务器部署Truemax_stepsAgent 参数任务最多执行的步数20进阶玩法自定义路径之外你更常见的需求是文件一落地就触发后续处理比如记日志、归档或上传。两者配合的方式很简单——给 Browser 的event_bus订阅 FileDownloadedEvent处理器里能拿到file_name、path、file_size等字段def on_file_downloaded(e): print(f已保存: {e.file_name} ({e.file_size} B) → {e.path}) # 订阅下载完成事件Agent 启动前调用即可 browser.event_bus.on(FileDownloadedEvent, on_file_downloaded)事件定义和监控实现分别在 events.py 与 downloads_watchdog.py 中想深入阅读源码可以从这两处入手。FAQQ怎么确认文件真的下载成功了A看终端里的 FileDownloadedEvent 日志或直接用文件管理器查看 downloads_path 目录。Q不指定 downloads_path 会发生什么A文件会存到系统临时目录下的随机文件夹里容易丢失生产环境务必显式指定。Q下载很大的文件会超时吗A下载本身由浏览器接管不会中断注意给 Agent 的步数留足避免任务中途停止。写在最后核心结论把保存路径交给downloads_path把后续动作交给FileDownloadedEvent订阅文件下载自动化就只剩一句任务描述。官方文档入口examples/features/download_file.py。【免费下载链接】browser-use Make websites accessible for AI agents. Automate tasks online with ease.项目地址: https://gitcode.com/GitHub_Trending/br/browser-use创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考