browser-auto-download

核心用法

Browser Auto Download 是一款基于 Playwright 的浏览器自动化下载工具，专为处理复杂下载场景设计。其核心流程采用三阶段策略：首先检测页面加载时触发的自动下载，其次执行多步导航查找平台专属页面（如 PC/Desktop 版本），最后回退到按钮点击式下载。支持 Windows/macOS/Linux 全平台架构自动识别（含 ARM64/Apple Silicon），内置滚动加载与延长等待机制应对懒加载内容。

显著优点

1. 动态内容适配：针对客户端渲染、JavaScript 生成的下载链接提供原生支持，弥补 curl/wget 的不足
2. 智能降级策略：三层递进式下载机制确保高成功率，无需人工干预即可处理复杂交互流程
3. 开箱即用：内置微信开发者工具、美图秀秀等常用软件快捷指令，支持一键式批量下载
4. 结构化输出：JSON 格式标准输出便于下游脚本集成，stderr 实时进度反馈利于调试

潜在局限

• 依赖 Chromium：需额外安装浏览器内核，首次部署约占用 150-300MB 磁盘空间
• 执行效率：相比直接 HTTP 请求存在显著延迟，不适合高频批量场景
• 反爬限制：部分站点可能检测自动化浏览器行为，需配合 headless 模式调整
• 维护成本：目标站点 DOM 结构变更可能导致选择器失效

适合人群

• 需要从动态 SPA 单页应用下载文件的开发者与运维人员
• 处理多平台分发页面（官网→PC 版→下载页）的自动化脚本编写者
• 缺乏直接下载链接、需模拟用户交互流程的软件分发场景

常规风险

该工具本质为受控浏览器自动化，风险等级取决于目标站点可信度。禁止用于绕过人机验证、破解下载限速或抓取受版权保护内容。建议仅在自有服务或明确授权的场景下使用，敏感操作建议配合沙箱环境执行。

核心功能

browser-auto-download 是一款基于 Playwright 的浏览器自动化下载工具，专为解决复杂下载场景设计。其核心能力包括：

• 自动下载捕获：监听页面加载时自动触发的下载事件
• 多步导航：从首页智能跳转至 PC/桌面版专属下载页
• 平台自动识别：自动匹配 Windows(x64/ARM64)、macOS(Intel/Apple Silicon)、Linux 架构
• 智能回退策略：自动下载 → 平台页导航 → 按钮点击的三层容错机制

显著优点

1. 解决传统工具盲区：完美处理客户端渲染、JavaScript 动态生成下载链接的场景
2. 零配置开箱即用：内置平台关键词库与常用软件快捷下载（微信开发者工具、美图秀秀等）
3. 全平台支持：细致区分的架构检测避免下载错误版本
4. 开发者友好：同时提供 CLI 工具与 Python 模块两种调用方式

潜在局限

1. SSRF 风险：直接访问用户提供的 URL，无域名白名单限制，存在内网探测风险
2. 依赖体积：Playwright + Chromium 初始安装体积较大（约 150MB+）
3. 性能开销：浏览器启动与页面渲染相比纯 HTTP 工具耗时显著增加
4. 动态内容依赖：部分网站反爬虫机制可能导致自动化失败

适合人群

• 需要下载客户端渲染站点的开发者/运维人员
• 批量获取跨平台软件安装包的自动化脚本编写者
• 无法使用 curl/wget 获取下载链接的 CI/CD 场景

常规风险

• SSRF（中危）：恶意 URL 可能导致内网服务探测
• 文件完整性：下载内容未经签名验证，需自行校验
• 依赖安全：Playwright 框架本身需信任 Microsoft 分发渠道