unsplash-image-search-download
Installation
SKILL.md
Unsplash Image Search Download
Use this skill to turn a user prompt into a downloaded Unsplash image file.
Workflow
- Confirm the search intent.
- Use the user prompt as
--query. - Keep nouns and style words that affect visuals (for example, "minimal office desk at sunrise").
- Default output directory to
downloads/unsplashunless the user gives a path.
- Prepare credentials.
- Set
UNSPLASH_ACCESS_KEYin the shell or pass--access-key. - Use the official API endpoints from references/unsplash-api.md; do not scrape Unsplash HTML pages.
- Run the script.
python visualizations/unsplash-image-search-download/scripts/find_and_download_unsplash.py --query "mountain sunset"