browser-auto-download

# Browser Auto Download v4.1.0 (Enhanced)

Download files from dynamic webpages with **intelligent detection and multi-step navigation**.

## Key Features

- **Auto-download capture**: Detects downloads triggered automatically on page load
- **Multi-step navigation**: Finds and navigates to platform-specific pages (PC/Desktop versions)
- **Platform auto-detection**: Windows x64/ARM64, macOS Intel/Apple Silicon, Linux
- **Event listening**: Captures all download events without requiring button clicks
- **Smart fallback**: Tries multiple strategies (auto-download, navigation, clicking)

## When to Use

Use this skill for:
- **Auto-download sites**: Downloads start automatically when page loads
- **Multi-step flows**: Homepage - click "PC version" - download page
- **Dynamic content**: Download links generated via JavaScript
- **Interactive downloads**: Requires clicking buttons or navigating UI

**NOT for**: Direct file URLs (use `curl`/`wget` instead)

## Quick Start

### Option 1: Automatic (Recommended)

```bash
python skills/browser-auto-download/scripts/auto_download.py \
  --url "https://example.com/download"
```

The script will:
1. Check for auto-downloads on page load
2. Look for platform-specific page links (PC/Desktop version)
3. Navigate if needed
4. Try clicking download buttons as fallback

### Option 2: Built-in Shortcuts

```bash
# WeChat DevTools
python skills/browser-auto-download/scripts/auto_download.py --wechat

# Meitu Xiuxiu
python skills/browser-auto-download/scripts/auto_download.py --meitu
```

### Option 3: Python Module

```python
from skills.browser-auto-download.scripts.auto_download import auto_download

result = auto_download(
    url="https://example.com/download",
    auto_select=True,   # Platform detection
    auto_navigate=True  # Multi-step navigation
)

if result:
    print(f"Downloaded: {result['path']}")
```

## How It Works

### Three-Stage Strategy

**Stage 1:...

# Browser Auto Download

[![Status](https://img.shields.io/badge/status-production--ready-brightgreen)](https://clawhub.com)
[![Success Rate](https://img.shields.io/badge/success-100%25-brightgreen)](#test-results)
[![Python](https://img.shields.io/badge/python-3.14+-blue)](https://www.python.org/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

> 🚀 Intelligent browser-automated file downloads with multi-modal support

Automatically download files from dynamic webpages using Playwright browser automation. Supports auto-downloads, multi-step navigation, direct links, relative paths, and precise button clicking with cross-platform (Windows/macOS/Linux) intelligent detection.

## ✨ Features

### 🎯 Multi-Modal Download Support

- **Auto-Download Detection** - Captures downloads triggered on page load (e.g., Meitu Xiuxiu)
- **Multi-Step Navigation** - Automatically finds and navigates to platform-specific pages
- **Direct Link Downloads** - Handles direct .exe/.dmg/.zip URLs (e.g., Python.org)
- **Relative Path Resolution** - Converts relative paths to absolute URLs (e.g., 7-Zip)
- **Precise Button Clicking** - Chinese/English selector support (e.g., WeChat DevTools)
- **Platform Auto-Detection** - Windows x64/ARM64, macOS Intel/Apple Silicon, Linux

### 🧠 Intelligent Download Strategy

The skill employs a **3-tier fallback system**:

```
Stage 1: Auto-Download Detection
  ├─ Page load triggers
  ├─ Direct links (.exe/.dmg/.zip)
  └─ Relative paths (a/file.exe)
        ↓ Fails
Stage 2: Multi-Step Navigation
  ├─ Find "PC/Desktop" links
  ├─ Auto-navigate to platform pages
  └─ Re-check for downloads
        ↓ Fails
Stage 3: Button Clicking
  ├─ Chinese selectors (稳定版 >> Windows 64)
  ├─ English selectors (Download for free)
  └─ Fallback to generic patterns
```

### 🌍 Cross-Platform Support

| System | Architecture | Auto-Detection |
|--------|--------------|-----------------|
| Windows | AMD64/x86_64 | ✅ windows, win64, x64, 64-bit |
| Win...