Download a file from a URL, or a whole list of URLs, into a folder - streamed to disk with a sensible filename guessed from the URL or server headers, skipping anything already downloaded.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
downloaddownload_list
download
Stream a single URL to a file in a folder, skipping it if that file already exists.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
url |
string | required | |
out_dir |
path | required | |
filename |
string |
optional, default ""
|
| Name | Type | Notes |
|---|---|---|
file |
path | |
skipped |
bool | |
bytes |
int |
download_list
Download every URL from a pasted list and/or a text file (one URL per line) into a folder, skipping files that already exist and reporting per-URL results.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
urls |
json |
optional, default []
|
|
list_file |
path |
optional, default ""
|
|
out_dir |
path | required |
| Name | Type | Notes |
|---|---|---|
count |
int | |
downloaded |
int | |
skipped |
int | |
failed |
int | |
out_dir |
path | |
results |
json |
python app.py --action download --params '{"url": "<url>", "out_dir": "D:/path/to/out_dir"}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("url-downloader", "download", {"url": "<url>", "out_dir": "D:/path/to/out_dir"}){
"id": "n0",
"app": "url-downloader",
"action": "download",
"params": {
"url": "<url>",
"out_dir": "D:/path/to/out_dir"
},
"inputs": {}
}python app.py --action download_list --params '{"out_dir": "D:/path/to/out_dir"}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("url-downloader", "download_list", {"out_dir": "D:/path/to/out_dir"}){
"id": "n0",
"app": "url-downloader",
"action": "download_list",
"params": {
"out_dir": "D:/path/to/out_dir"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.