unsplash
by brokenwatch24
Image & Video GenerationBrief
Search, browse, and download high-quality free photos from Unsplash's library of millions of images.
Description
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
User asks: Find 3 landscape photos of forests and return small preview URLs
- 1
Call /search/photos with query=forest, orientation=landscape, per_page=3
- 2
Parse results array to extract photo IDs and urls.small fields
- 3
Call /photos/:id/download for each result to comply with API guidelines
- 4
Return preview URLs alongside photographer names and profile links
3 forest landscape preview URLs with photographer attribution ready for display
Requirements
- Unsplash developer account (free) at unsplash.com/developers
- Unsplash Access Key obtained by registering an application in the developer dashboard
Installation
clawhub install brokenwatch24/unsplashRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.