本文へ移動
cccskills
無料GitHub で公開

image-well

Search and download images from 15 APIs in parallel (Openverse, Pexels, Pixabay, Met Museum, Cleveland Museum, Art Institute of Chicago, Getty Museum, NASA, Rijksmuseum, Wikimedia Commons, Unsplash, Smithsonian, Europeana, Iconify, Pollinations AI). Supports license filtering, presets (military, museum, stock), cached results, and bulk download with metadata sidecars. Triggers on find images, stock photos, public domain artwork, museum images, CC-licensed, NASA photos, icons.

インストール方法を見る

含まれるファイル(21)

  • SKILL.md5.6 KB
  • README.md9.4 KB
  • scripts/_well_utils.py25.7 KB
  • scripts/sources/__init__.py2.5 KB
  • scripts/sources/artic.py3.9 KB
  • scripts/sources/base.py1.8 KB
  • scripts/sources/cleveland.py3.9 KB
  • scripts/sources/europeana.py3.3 KB
  • scripts/sources/getty.py3.6 KB
  • scripts/sources/iconify.py2.3 KB
  • scripts/sources/met_museum.py3.7 KB
  • scripts/sources/nasa.py3.0 KB
  • scripts/sources/openverse.py2.8 KB
  • scripts/sources/pexels.py2.2 KB
  • scripts/sources/pixabay.py2.3 KB
  • scripts/sources/pollinations.py2.2 KB
  • scripts/sources/rijksmuseum.py2.5 KB
  • scripts/sources/smithsonian.py5.1 KB
  • scripts/sources/unsplash.py2.6 KB
  • scripts/sources/wikimedia.py2.9 KB
  • scripts/well.py12.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Image Well

Search and download images from 15 sources through a single CLI. Seven sources work with zero API keys (Openverse, Wikimedia, Met Museum, Cleveland Museum, Art Institute of Chicago, Getty Museum, NASA). Additional sources activate when keys are set.

Quick Start

# Search across all no-key sources
uv run ~/.claude/skills/image-well/scripts/well.py search "ancient Minoan fresco"

# Use a preset for domain-specific searches
uv run ~/.claude/skills/image-well/scripts/well.py search "F-35 fighter jet" --preset military

# Download results with metadata sidecars
uv run ~/.claude/skills/image-well/scripts/well.py search "sunset" --format download --output ./images/

# Check which sources are available
uv run ~/.claude/skills/image-well/scripts/well.py sources

# Visual HTML preview — opens in browser, no context pollution
uv run ~/.claude/skills/image-well/scripts/well.py search "bronze statue" --format html

# Output as JSON for piping
uv run ~/.claude/skills/image-well/scripts/well.py search "cat" --format json

Sources

TierSourceKey RequiredLicense
1Openverse (800M+)NoCC variants
1Wikimedia CommonsNoCC variants
1Met Museum (375k)NoCC0
1Cleveland Museum (37k)NoCC0
1Art Inst. Chicago (60k+)NoPublic Domain
1Getty Museum (Open Content)NoCC0
1NASA (140k)NoPublic Domain
2PexelsPEXELS_API_KEYPexels License
2PixabayPIXABAY_API_KEYPixabay License
2Rijksmuseum (700k)RIJKSMUSEUM_API_KEYCC0
2UnsplashUNSPLASH_ACCESS_KEYUnsplash License
3SmithsonianNoCC0
3Europeana (50M+)EUROPEANA_API_KEYMixed
3Iconify (275k icons)NoVarious
3Pollinations AINoFree Use (AI gen)

Add Tier 2 keys to ~/.config/env/secrets.env for expanded coverage.

Source notes:

  • Cleveland downloads the ~3400px print JPEG; the ~900px web derivative is the thumbnail. The archival TIFFs are never fetched.
  • Art Institute of Chicago images are public domain (PD), not formally CC0 — --license cc0 accepts them. Downloads use AIC's preferred 843px IIIF size and are serialized (1/s) per their API etiquette.
  • Getty rides the collection website's undocumented JSON search API (open_content=true filter) — the only keyword-search surface Getty exposes. Every emitted row is gated on the CC0 URI in its IIIF manifest license; downloads at 1200px IIIF. Superb Greek/Roman/Etruscan; thin on Egypt/Near East.

Museum Collections on Wikimedia Commons

Some museums have no usable API but mass-uploaded their images to Wikimedia Commons. Search them through the existing wikimedia source with a category-scoped query:

MuseumCommons FilesExample
Walters Art Museum~18,600incategory:"Media contributed by the Walters Art Museum" scarab

The Walters v1 API closed in 2023 and the whole thewalters.org domain (including its image CDN) sits behind Cloudflare bot protection — Commons is the only programmatic path. Note the 2012 Walters upload was recorded as CC BY-SA 3.0 (many files also carry a Public Domain Mark); keep the per-file license Commons reports rather than assuming CC0.

Presets

PresetSourcesUse Case
militarynasa, wikimedia, smithsonianDefense/military imagery
museummet, cleveland, artic, getty, rijksmuseum, smithsonianArt, antiquities, historical
texturewikimedia, pollinationsGame dev, 3D materials
stockpexels, pixabay, unsplashEditorial photography
all-freeopenverse, wikimedia, met, cleveland, artic, getty, nasa, smithsonianAll no-key sources

Options

--sources NAME [...]    Specific sources to search
--preset NAME           Use a preset group
--limit N               Max results per source (default: 10)
--license LICENSE       Filter: cc0, cc-by, cc-by-sa, any
--format FORMAT         table, json, download, urls, html, tunnel
--output DIR            Download directory (default: ./well-images/)
--no-cache              Skip result cache
--timeout N             Per-source timeout in seconds (default: 15)
--quiet                 Suppress progress output

Workflows

Source images for a project

# Search, review in table, then download the good ones
uv run well.py search "Mediterranean landscape" --preset stock --format json > results.json
# Review results.json, then download specific URLs

Build an image corpus

# Download CC0 images for a research project
uv run well.py search "Bronze Age pottery" --preset museum --license cc0 --format download --output ./corpus/

Pipe to image-forge for processing

# Search, download, then resize with image-forge
uv run well.py search "sunset" --format download --output ./raw/
# Then use image-forge skill to process downloaded images

Cache

Results are cached for 24 hours at ~/.cache/image-well/.

uv run well.py cache stats    # Show cache size
uv run well.py cache clear    # Clear all cached results

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Search academic papers, build literature reviews, and synthesize research findings — combines Exa MCP (research_paper category, arxiv filtering) with arxiv-mcp-server for paper discovery, download, and deep analysis. Triggers on academic paper, literature review, research synthesis, arxiv, find papers, scholarly search.

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

This skill should be used when creating, auditing, or maintaining AGENTS.md files and Codex CLI configuration for any project—including initializing AGENTS.md for cross-agent compatibility (Codex, Cursor, Copilot, Devin, Jules, Amp, Gemini CLI), generating config.toml or .rules files, scaffolding .agents/skills/, converting CLAUDE.md to AGENTS.md, or auditing existing agent configs for bloat and staleness. Complementary to codex-orchestrator (which executes subagents; this skill creates the config files they consume).

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

Academic research skill for Biblical Hebrew, Semitic linguistics, cuneiform studies, and comparative Ancient Near Eastern research. Provides Sefaria API for Hebrew Bible, CDLI/ORACC for cuneiform databases, and web discovery via Omnisearch, Exa, Firecrawl, and Obscura for finding scholarly sources across JSTOR, Perseus, Persée, Google Scholar, and academia.edu. Triggers on Hebrew quotes, cuneiform, Sefaria, ANE research, Minoan, search for scholarship, find papers, literature review, scholarly search, academic search, Genesis/Tehom, Ugaritic, Talmudic sources, extract from PDF, OCR academic.

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

Build comprehensive ARCHITECTURE.md files following matklad's canonical guidelines — bird's-eye views, ASCII/Mermaid diagrams, codemaps, invariants, and layer boundaries. Triggers on document the architecture, create ARCHITECTURE.md, map this codebase, architectural overview.

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

Generate physically-based atmospheric scattering shaders — sky domes, planetary atmospheres, LUT-optimized pipelines, depth-aware post-processing. Four modes — sky-dome, atmosphere-post, planet, lut. Triggers on atmospheric scattering, sky shader, sunset rendering, planet atmosphere, Rayleigh scattering, Mie scattering, volumetric sky, sky dome, atmosphere post-processing, aerial perspective, transmittance LUT, sky rendering, realistic sky, planetary rendering.

日本語の概要は準備中です。原文の説明を表示しています。

tdimino/claude-code-minoan412026年9月28日 更新

tdimino のスキルをすべて見る

このスキルの問題を報告する