Download every image on a web page: fetches the page, finds <img> src/srcset (plus lazy-load data-src fallbacks), resolves relative URLs, and saves each image into a folder - skipping images smaller than a minimum size and byte-identical duplicates.
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:
list_imagesdownload
list_images
Fetch a page and list every image URL it references (img src/srcset, lazy-load attributes), without downloading anything.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
url |
string | required |
| Name | Type | Notes |
|---|---|---|
count |
int | |
images |
json |
download
Fetch a page, find every image it references, and download each into a folder - skipping images narrower/shorter than min_width and byte-identical duplicates. Leave min_width at 0 for no size filter.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
url |
string | required | |
out_dir |
path | required | |
min_width |
int |
optional, default 0
|
| Name | Type | Notes |
|---|---|---|
found |
int | |
downloaded |
int | |
skipped |
int | |
failed |
int | |
out_dir |
path | |
results |
json |
python app.py --action list_images --params '{"url": "<url>"}'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("page-image-downloader", "list_images", {"url": "<url>"}){
"id": "n0",
"app": "page-image-downloader",
"action": "list_images",
"params": {
"url": "<url>"
},
"inputs": {}
}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("page-image-downloader", "download", {"url": "<url>", "out_dir": "D:/path/to/out_dir"}){
"id": "n0",
"app": "page-image-downloader",
"action": "download",
"params": {
"url": "<url>",
"out_dir": "D:/path/to/out_dir"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.