LaunchKit · 2026
Back to Skills

Search, browse, and download high-quality free photos from Unsplash's library of millions of images.

2
716 downloads
by @brokenwatch24

Setup & Installation

openclaw skills install @brokenwatch24/unsplash

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install unsplash

What This Skill Does

Provides access to Unsplash's photo library via their REST API. Supports searching by keyword, color, and orientation, fetching random photos, browsing collections, and retrieving full photo metadata with dynamic image URLs and blur hash placeholders.

Images are served directly from Unsplash's CDN and support dynamic resizing via URL parameters, so you never need to download and reprocess full-resolution files.

When to use it

  • Finding a hero image for a blog post by keyword
  • Pulling a random nature photo for a daily wallpaper script
  • Searching black-and-white portrait photos for a design mockup
  • Browsing a curated Unsplash collection for editorial content
  • Getting photographer attribution details before publishing

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Find 3 landscape photos of forests and return small preview URLs

AGENT
  1. 1Call /search/photos with query=forest, orientation=landscape, per_page=3
  2. 2Parse results array to extract photo IDs and urls.small fields
  3. 3Call /photos/:id/download for each result to comply with API guidelines
  4. 4Return preview URLs alongside photographer names and profile links
OUTPUT

3 forest landscape preview URLs with photographer attribution ready for display

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Unsplash developer account (free) at unsplash.com/developersUnsplash Access Key obtained by registering an application in the developer dashboard