Website Image Downloader

网站图片下载器 — API 和 MCP 示例

从任何网站下载所有图片（或仅提取其 URL），并获取宽度、高度、格式、文件大小和替代文本——可打包为 ZIP、通过 REST API 获取，或通过 MCP 作为 AI Agent 的工具使用。已过滤图标、精灵图和跟踪像素；支持处理 srcset、<picture> 和延迟加载的图片。

此代码仓库包含适用于托管版 网站图片下载器（Apify Actor sste/website-image-downloader）的开箱即用示例，以及依赖精简的 Python 和 JavaScript 自行提取工具。

商店页面	https://apify.com/sste/website-image-downloader
文档和指南	https://website-image-downloader.pages.dev
MCP 服务	https://mcp.apify.com?tools=sste/website-image-downloader
定价	每 1,000 张图片 $0.20 · 列表模式下每 1,000 个 URL $0.05 · 每次运行 $0.001

快速开始（cURL）

export APIFY_TOKEN=...   # Apify Console → Settings → Integrations
bash curl/download-all-images.sh https://www.example.com/
bash curl/list-image-urls.sh https://www.example.com/

Python

pip install "apify-client>=3"
python python/download_images.py https://www.example.com/     # writes images.zip + images.csv
python python/diy_extract_image_urls.py https://www.example.com/  # no API, requests + BeautifulSoup

JavaScript / Node.js

npm i apify-client cheerio
node javascript/download-images.mjs https://www.example.com/
node javascript/diy-extract-image-urls.mjs https://www.example.com/

AI Agent（MCP）

客户端	配置
Claude Desktop / Cursor / Windsurf	mcp/claude_desktop_config.json
VS Code（.vscode/mcp.json）	mcp/vscode-mcp.json
Claude Code	claude mcp add --transport http website-image-downloader "https://mcp.apify.com?tools=sste/website-image-downloader"
任意客户端（stdio）	npx -y @apify/actors-mcp-server --tools sste/website-image-downloader

提示词示例：mcp/prompts.md。注册表条目：server.json（io.github.SSTEmpresarial/website-image-downloader）。

托管工具的处理内容

• 最大的 srcset / <picture> 候选项、延迟加载属性（data-src、data-srcset、data-lazy-src、data-original、data-bg）、<noscript>、CSS 背景、og:image
• 从文件字节中获取实际宽度/高度/格式；按大小、格式和 URL 文本筛选；软 404 检测；SHA-256 去重
• 模式：download（ZIP + 行数据）、inspect（仅行数据）、list（仅 URL）
• 同站点爬取（深度 1–3）、支出上限

指南：下载网站上的所有图片 · 提取图片 URL · 过滤图标和跟踪像素 · srcset 和延迟加载 · Shopify

仅下载您有权使用的图片。示例采用 MIT 许可证。