What is material-collector?

Claude Code / Agent Skill：用 gallery-dl 收集設計素材並產出情緒板。內建實測來源路線(Pinterest/Flickr/ArtStation),知道哪個站抓哪類圖。. It is open-source on GitHub.

Is material-collector free to use?

material-collector is open-source under the MIT license, so it is free to use.

What category does material-collector belong to?

material-collector is listed under skills in the Claudeers registry of Claude-compatible tools.

素材收集官 · material-collector

一個 Claude Code / Agent Skill:用 gallery-dl 把設計師的創作意圖翻譯成精準的素材搜尋 → 下載 → 按主題歸檔，並產出情緒板（moodboard）。

重點不是「會下載」，而是**「找對圖」** —— 內建經實測的來源路線，知道哪個站抓哪類圖、哪些站被反爬牆擋、哪些站有 NSFW 風險。

🚀 安裝

方式一（推薦）：直接叫你的 agent 裝

把下面這段話整段貼給你的 agent（Claude Code / Codex 等），它會自己判斷該放哪、用 git 裝好：

請幫我安裝 material-collector 這個 skill：
用 git clone https://github.com/dseditor/material-collector.git
放到你目前環境的 skills 目錄
（Claude Code 用 ~/.claude/skills/material-collector；
Codex 或其他 agent 放到對應的 skills/ 目錄）。
clone 完讀一下根目錄的 SKILL.md 確認成功，再告訴我裝在哪。

用白話講就是「請幫我 clone https://github.com/dseditor/material-collector.git 裝成 skill」。 Claude / Codex 環境多半都已有 git，agent 會自行處理路徑與驗證。

方式二：自己手動 clone

skill 資料夾即 repo 根（根目錄就是 SKILL.md），一行 git clone 到對應目錄即可：

# Claude Code — macOS / Linux
git clone https://github.com/dseditor/material-collector.git ~/.claude/skills/material-collector

# Claude Code — Windows (PowerShell)
git clone https://github.com/dseditor/material-collector.git $env:USERPROFILE\.claude\skills\material-collector

更新到最新版：cd 進該目錄後 git pull。

裝好後，對 agent 說「收集素材」「找參考圖」「做情緒板」「gallery-dl」即可觸發。

前置：取得 gallery-dl（免 Python）

本 skill 用官方 nightly 獨立執行檔（gdl-org/builds），內含 Python runtime，Windows / Mac 都免裝 Python。/releases/latest/download/ 是永久連結，永遠抓到最新版：

Windows (PowerShell)

New-Item -ItemType Directory -Force F:/materials/bin | Out-Null
curl.exe -L -o F:/materials/bin/gallery-dl.exe https://github.com/gdl-org/builds/releases/latest/download/gallery-dl_windows.exe
F:/materials/bin/gallery-dl.exe --version

macOS

mkdir -p ~/materials/bin
curl -L -o ~/materials/bin/gallery-dl https://github.com/gdl-org/builds/releases/latest/download/gallery-dl_macos
chmod +x ~/materials/bin/gallery-dl
~/materials/bin/gallery-dl --version

情緒板功能另需 Pillow（python -m pip install --user Pillow）。

已驗證的來源路線（實測 2026-06-28）

核心觀念：能下載 ≠ 找得對。 同一句關鍵字在不同站得到完全不同性質的內容，選錯來源就算抓一堆也是雜訊。

設計用途	首選	補充	別用
室內 / 建築 / 空間風格情緒板	Pinterest	ArtStation（CG）	Wallhaven、Flickr
CG / 概念美術 / 遊戲場景	ArtStation	Pinterest	Flickr
真實攝影主題（自然/街拍/實物）	Flickr	500px（限定網址）	Pinterest
構圖 / 配色 / UI 靈感	Pinterest	Behance、Dribbble	—

反爬牆與登入狀態

站台	免登入可抓	備註
Pinterest	✅	公開搜尋直抓；僅私密 board / feed 才需 cookies
Flickr	✅	內建 public API key，連申請都不用
ArtStation	✅	直接可抓（CG 渲染，非實拍）
Wallhaven	✅	有 NSFW 風險，務必 `&purity=100`；設計用途建議避開
500px	⚠️	只吃 `500px.com/<user>` 或單張 URL，搜尋頁不支援
Unsplash	❌	Anubis 工作量證明牆，改走官方 API
Pexels	❌	Cloudflare 挑戰，改走官方 API

擋 gallery-dl 的是「需瀏覽器跑 JS 解題」的反爬牆（Anubis / Cloudflare）。gallery-dl 是純 HTTP client 不跑 JS，換 IP / 加 sleep / 餵 cookie 都救不了 → 這類站改用官方 API。

快速使用

GDL="F:/materials/bin/gallery-dl.exe"   # 或 ~/materials/bin/gallery-dl

# 1) 先模擬看量（任何正式抓取前必做）
"$GDL" --simulate --range "1-5" "https://www.pinterest.com/search/pins/?q=japandi%20wood%20kitchen"

# 2) 正式抓取，按主題歸檔 + 封存去重 + 禮貌限速
"$GDL" -D "F:/materials/japandi-wood-kitchen" \
  --filename "{category}_{id}.{extension}" \
  --download-archive "F:/materials/japandi-wood-kitchen/.archive.sqlite3" \
  --range "1-30" --sleep-request 1.5 \
  "https://www.pinterest.com/search/pins/?q=japandi%20wood%20kitchen"

# 3) 品質把關 + 輸出情緒板
python assets/scripts/make_contactsheet.py "F:/materials/japandi-wood-kitchen" --cols 4 --thumb 360

檔案結構

material-collector/
├── SKILL.md                      # 主流程（agent 進入點）
├── references/                   # 漸進式參考（按需讀取）
│   ├── sites.md                  # ★ 用途→來源、各站實測品質、反爬牆狀態、內容安全
│   ├── filtering.md              # --filter 表達式 / -K 探索欄位
│   ├── templates.md              # 目錄 / 檔名模板
│   ├── config.md                 # config.json 設定
│   ├── postprocess.md            # 去重 / 分類 / 情緒板 / 編目
│   ├── auth.md                   # cookies / API key（含 Windows 瀏覽器實測差異）
│   └── etiquette.md              # 限速 / 重試 / 避免封鎖
├── assets/
│   ├── config.template.json      # gallery-dl 設定範本
│   └── scripts/
│       ├── make_contactsheet.py  # 情緒板 / 縮圖牆
│       ├── build_catalog.py      # 可瀏覽 HTML 索引
│       └── collect.bat           # Windows 一鍵收集（全英文）
└── examples/                     # 端到端範例

核心原則

先模擬再下載：正式抓取前一定 --simulate 看量。
數量設上限：用 --range / -A，別讓搜尋頁無限翻頁。
禮貌限速：加 --sleep-request，尊重來源站台。
選對來源勝過抓得多：依用途選已實測的來源，偏題就換站。
交付前先把關：用情緒板目視抽查，剔除文字拼圖 / NSFW / 偏題雜訊。

授權

MIT License — 見 LICENSE。

來源路線判定為 2026-06-28 實測結果；站台反爬牆政策會變動，若行為改變請更新 references/sites.md 的日期與判定。

material-collector

素材收集官 · material-collector

🚀 安裝

方式一（推薦）：直接叫你的 agent 裝

方式二：自己手動 clone

前置：取得 gallery-dl（免 Python）

已驗證的來源路線（實測 2026-06-28）

快速使用

檔案結構

核心原則

授權

// compatibility

// faq

// embed badge

// retro hit counter

// reviews

// guestbook

// related in Claude Skills

Platforms	api
Operating systems	—
AI compatibility	claude
License	MIT
Pricing	open-source
Language	Python