SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场image-well

image-well

设计与创作

查看项目

更新于 10-16 10:13

技能介绍

用途

Image Well 是一个命令行图像搜索与下载工具，可从 15 个图像来源并行检索图片。它面向需要为项目、研究或创作批量获取图片的场景，通过单一 CLI 统一访问多个图库、博物馆和素材站点。

主要能力

  • 多源并行搜索：同时查询多个图像来源，汇总结果。
  • 零密钥来源：7 个来源无需 API 密钥即可使用——Openverse（8 亿+）、Wikimedia Commons、大都会博物馆（37.5 万）、克利夫兰艺术博物馆（3.7 万）、芝加哥艺术博物馆（6 万+）、盖蒂博物馆（开放内容）、NASA（14 万）。
  • 密钥来源：设置密钥后启用 Pexels、Pixabay、Rijksmuseum（70 万）、Unsplash、Europeana（5000 万+）等。
  • 预设分组：提供 military、museum、texture、stock、all-free 等预设，针对不同领域快速选择来源。
  • 许可证过滤：支持按 cc0、cc-by、cc-by-sa、any 过滤结果。
  • 多种输出格式：table、json、download、urls、html、tunnel。HTML 格式可在浏览器中预览且不污染上下文；JSON 格式便于管道处理。
  • 元数据附带：下载时可生成元数据 sidecar 文件。
  • 结果缓存：结果缓存 24 小时，位于 ~/.cache/image-well/。

使用方式

基本搜索：

uv run ~/.claude/skills/image-well/scripts/well.py search "ancient Minoan fresco"

使用预设：

uv run ~/.claude/skills/image-well/scripts/well.py search "F-35 fighter jet" --preset military

下载结果并附带元数据：

uv run ~/.claude/skills/image-well/scripts/well.py search "sunset" --format download --output ./images/

查看可用来源：

uv run ~/.claude/skills/image-well/scripts/well.py sources

HTML 预览：

uv run ~/.claude/skills/image-well/scripts/well.py search "bronze statue" --format html

JSON 输出：

uv run ~/.claude/skills/image-well/scripts/well.py search "cat" --format json

主要选项：

  • --sources NAME [...]：指定来源
  • --preset NAME：使用预设分组
  • --limit N：每个来源最大结果数（默认 10）
  • --license LICENSE：许可证过滤
  • --format FORMAT：输出格式
  • --output DIR：下载目录（默认 ./well-images/）
  • --no-cache：跳过结果缓存
  • --timeout N：每个来源超时秒数（默认 15）
  • --quiet：抑制进度输出

缓存管理：

uv run well.py cache stats    # 显示缓存大小
uv run well.py cache clear    # 清除所有缓存结果

适用场景

  • 为项目寻找配图：搜索、表格审阅后下载合适的图片。
  • 构建图像语料库：按许可证过滤批量下载 CC0 图片用于研究。
  • 与 image-forge 配合：先下载原始图片，再用 image-forge 技能处理。
  • 游戏开发与 3D 材质：使用 texture 预设。
  • 编辑摄影：使用 stock 预设。
  • 艺术、文物与历史：使用 museum 预设。
  • 国防/军事图像：使用 military 预设。

来源说明与限制

  • 克利夫兰艺术博物馆：下载约 3400px 的 print JPEG，约 900px 的 web 衍生图为缩略图；不获取存档 TIFF。
  • 芝加哥艺术博物馆：图片为公有领域（PD），非正式 CC0，但 --license cc0 会接受；下载使用 AIC 偏好的 843px IIIF 尺寸，并按 API 礼仪串行化（1/秒）。
  • 盖蒂博物馆：使用其网站未公开的 JSON 搜索 API（open_content=true 过滤），这是盖蒂唯一暴露的关键词搜索接口；每行结果均以其 IIIF 清单许可证中的 CC0 URI 为准；下载为 1200px IIIF。希腊/罗马/伊特鲁里亚藏品出色，埃及/近东较薄弱。
  • Wikimedia Commons 上的博物馆藏品：部分博物馆无可用的 API，但已将图片批量上传至 Wikimedia Commons，可通过 wikimedia 来源配合分类限定查询。例如 Walters Art Museum 约 18,600 个文件，查询示例：incategory:"Media contributed by the Walters Art Museum" scarab。Walters v1 API 已于 2023 年关闭，整个 thewalters.org 域名（含图片 CDN）受 Cloudflare 机器人保护，Commons 是唯一程序化路径。注意 2012 年 Walters 上传记录为 CC BY-SA 3.0（许多文件也带有公有领域标记），应以 Commons 报告的每个文件许可证为准，而非假定为 CC0。
  • 密钥配置：将 Tier 2 密钥添加到 ~/.config/env/secrets.env 以扩展覆盖范围。
  • 各来源的许可证类型不同，包括 CC 变体、CC0、公有领域、Pexels License、Pixabay License、Unsplash License、混合许可证、Various、Free Use（AI 生成）等，使用时需注意遵守相应许可条款。