Website Image Downloader

Website Image Downloader — API と MCP の例

任意のウェブサイトからすべての画像をダウンロード（または URL のみを抽出）できます。幅、高さ、形式、ファイルサイズ、代替テキストも取得でき、ZIP、REST API、または MCP 経由の AI エージェント向けツールとして利用できます。アイコン、スプライト、トラッキングピクセルは除外され、srcset、<picture>、遅延読み込み画像にも対応しています。

このリポジトリには、ホスト型の Website Image Downloader（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 · リストモードでは URL 1,000 件あたり $0.05 · 実行 1 回あたり $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 エージェント（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 ライセンスです。