Image Fetcher

Fetch relevant, high-quality, free-to-use images from the web — from any AI coding tool.

Context-aware search, curated picks from Unsplash/Pexels/Pixabay, and direct download to your project. Works with zero configuration.

View Live Demo

How It Works

Image Fetcher understands your project context and finds the right images without you having to leave your editor.

Phase 1: Context Detection  → Uses your input, or scans README/package.json/CSS for context
Phase 2: Image Sourcing      → Searches Unsplash, Pexels, Pixabay via API or WebSearch fallback
Phase 3: Curate & Present    → Shows 5 candidates with descriptions, sizes, sources
Phase 4: Download & Save     → Descriptive filenames to ./assets/images/
Phase 5: Summary             → File paths, sizes, source links, license info

If no input is given, the skill scans your project directory for context signals — README, package.json, CSS custom properties, existing assets — and generates relevant search queries automatically.

Zero Config

Works out of the box with no API keys via WebSearch. For better results, optionally add free API keys:

| Source | Free Tier | Signup | |--------|-----------|--------| | Unsplash | 50 req/hr | unsplash.com/developers | | Pexels | 200 req/hr | pexels.com/api | | Pixabay | 100 req/min | pixabay.com/api/docs |

Add keys to skills/image-fetcher/config.json:

{
  "unsplash_key": "your-key-here",
  "pexels_key": "your-key-here",
  "pixabay_key": "your-key-here",
  "default_count": 5,
  "output_dir": "assets/images"
}

Image Sources & Licensing

All images come from platforms with permissive free-to-use licenses:

• Unsplash — Free for commercial and non-commercial use, no attribution required
• Pexels — Free for all purposes, attribution appreciated but not required
• Pixabay — Free for commercial use, no attribution required

The WebSearch fallback specifically targets these three platforms to ensure license compliance.

Installation

Image Fetcher is a markdown-based skill/rule that works with any AI coding assistant. Pick your tool below.

Add the marketplace and install the plugin:

/plugin marketplace add sacredvoid/image-fetcher
/plugin install image-fetcher@sacredvoid-image-fetcher

Then use it:

/image-fetcher hero image for a coffee shop website
/image-fetcher                    # scans current dir for context

Add as a Cursor Rule:

1. Create .cursor/rules/image-fetcher.mdc in your project
2. Copy the contents of skills/image-fetcher/SKILL.md into it
3. Add the frontmatter:

---
description: Fetch relevant free-to-use images from the web
globs:
alwaysApply: false
---

Invoke by asking: "Use the image-fetcher rule to find hero images for my landing page"

Add as a Windsurf Rule:

1. Create .windsurfrules/image-fetcher.md in your project
2. Copy the contents of skills/image-fetcher/SKILL.md into it

Invoke by asking: "Use the image-fetcher rule to find product photos"

Add as a Copilot Instruction:

1. Create .github/copilot-instructions.md in your project (or append to existing)
2. Copy the contents of skills/image-fetcher/SKILL.md into it

Invoke by asking: "Follow the image-fetcher instructions to find background images"

Add as a Cline Rule:

1. Create .clinerules/image-fetcher.md in your project
2. Copy the contents of skills/image-fetcher/SKILL.md into it

Invoke by asking: "Use the image-fetcher rule to find team photos"

Add as a Continue Rule:

1. Create .continue/rules/image-fetcher.md in your project
2. Copy the contents of skills/image-fetcher/SKILL.md into it

Invoke by asking: "Use the image-fetcher rule to find banner images"

Add as an Aider Convention:

1. Create .aider.conf.yml in your project (or append to existing)
2. Add: read: skills/image-fetcher/SKILL.md

Or use the --read flag: aider --read skills/image-fetcher/SKILL.md

Add as a Zed Prompt:

1. Create .zed/prompts/image-fetcher.md in your project
2. Copy the contents of skills/image-fetcher/SKILL.md into it

Enable in Zed's AI assistant settings, then invoke by asking about image fetching.

The skill is a standalone markdown file. You can use it with any AI coding tool that supports custom instructions or system prompts:

1. Copy skills/image-fetcher/SKILL.md into your tool's instruction/rule format
2. The AI will follow the workflow: context detection → search → present → download

Output

Images are saved to ./assets/images/ (configurable) with descriptive filenames:

assets/images/
├── cozy-cafe-warm-lighting-01.jpg      (1920x1280, 286 KB)
├── mountain-reflection-lake-02.jpg     (1920x1280, 406 KB)
├── minimalist-white-interior-03.jpg    (2000x1333, 447 KB)
├── sunset-golden-hour-04.jpg           (1920x1241, 494 KB)
└── aerial-city-skyline-05.jpg          (1920x1280, 138 KB)

Each download includes a summary with file paths, dimensions, file sizes, source URLs, photographer credits, and license information.

License

MIT