download
Download files from URLs to disk with secure defaults including ECH encryption and DoH. Supports proxies, custom headers, and file size limits up to 2GB.
Instructions
Download a file from a URL and save it to disk. Supports binary and text files. For reading web page content as text, use the webfetch tool. Features: ECH (Encrypted Client Hello) and DoH (DNS over HTTPS) enabled by default. Supports HTTP and SOCKS5 proxies. SSRF protection blocks private/internal IPs. Max download size: 100 MB (adjustable via max_size_mb, hard limit 2 GB).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | URL of the file to download,required | |
| output_path | Yes | Absolute path to save the downloaded file,required | |
| headers | No | Custom HTTP headers (e.g. User-Agent, Referer, Authorization) | |
| overwrite | No | Overwrite existing file. Default: false | |
| timeout_sec | No | Request timeout in seconds. Default: 60, Max: 600 | |
| max_size_mb | No | Maximum download size in MB. Default: 100, Max: 2048 | |
| proxy_url | No | HTTP or SOCKS5 proxy URL (e.g. http://proxy:8080, socks5://proxy:1080) | |
| no_doh | No | Disable DNS over HTTPS. Default: false (DoH enabled) | |
| no_ech | No | Disable Encrypted Client Hello. Default: false (ECH enabled) |