Agent skill
unsplash-cli
Use cli-web-unsplash to answer questions about Unsplash photos, search for free images by keyword, download photos, browse photo topics and collections, view photographer profiles, get photo details (EXIF, location, tags), and discover random photos. Invoke this skill whenever the user asks about Unsplash, free stock photos, searching for images, downloading images, photo topics, photographer profiles, photo collections, or wants to find or download images by keyword, orientation, or color. Always prefer cli-web-unsplash over manually fetching the Unsplash website.
Install this agent skill to your Project
npx add-skill https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/unsplash/agent-harness/cli_web/unsplash/skills
SKILL.md
cli-web-unsplash
CLI for searching and discovering photos on Unsplash. Installed at: cli-web-unsplash.
Quick Start
# Search for photos
cli-web-unsplash photos search "mountains" --json
# Get photo details
cli-web-unsplash photos get SyfvrXRy28Y --json
# Browse topics
cli-web-unsplash topics list --json
Always use --json when parsing output programmatically.
Commands
photos search <query>
Search photos by keyword with optional filters.
cli-web-unsplash photos search "sunset" --orientation landscape --color orange --per-page 10 --json
Key options: --orientation (landscape/portrait/squarish), --color, --order-by (relevant/latest), --page, --per-page
Output fields: total, total_pages, results[] with id, description, width, height, likes, color, author, url, link, premium
photos get <photo_id>
Get full photo details including EXIF, location, and tags.
cli-web-unsplash photos get SyfvrXRy28Y --json
Output fields: id, slug, description, width, height, color, likes, views, downloads, created_at, author ({username, name}), urls, exif (camera, aperture, exposure, focal_length, iso), location (name, city, country, latitude, longitude), tags[], premium, link
photos random
Get random photo(s), optionally filtered.
cli-web-unsplash photos random --query "nature" --count 3 --orientation landscape --json
photos download <photo_id>
Download a photo to disk.
cli-web-unsplash photos download Bkci_8qcdvQ --size full -o mountain.jpg --json
Key options: --size (raw/full/regular/small/thumb, default: full), --output / -o (file path)
Output fields (JSON): photo_id, size, file, bytes, description
photos stats <photo_id>
Get photo view and download statistics.
cli-web-unsplash photos stats SyfvrXRy28Y --json
topics list
List available photo topics.
cli-web-unsplash topics list --json
topics get <slug>
Get topic details.
cli-web-unsplash topics get nature --json
topics photos <slug>
List photos in a topic.
cli-web-unsplash topics photos nature --per-page 10 --order-by popular --json
collections search <query>
Search photo collections.
cli-web-unsplash collections search "wallpapers" --json
collections get <id>
Get collection details.
cli-web-unsplash collections get 1065976 --json
collections photos <id>
List photos in a collection.
cli-web-unsplash collections photos 1065976 --per-page 10 --json
users search <query>
Search users by name.
cli-web-unsplash users search "landscape" --json
users get <username>
Get user profile.
cli-web-unsplash users get unsplash --json
users photos <username>
List photos by a user.
cli-web-unsplash users photos unsplash --order-by popular --json
users collections <username>
List collections by a user.
cli-web-unsplash users collections unsplash --json
Agent Patterns
# Find landscape photos of mountains and get the first result's details
cli-web-unsplash photos search "mountains" --orientation landscape --per-page 1 --json | python -c "import json,sys; d=json.load(sys.stdin); print(d['results'][0]['url'])"
# Get a random nature photo URL
cli-web-unsplash photos random --query "nature" --json | python -c "import json,sys; d=json.load(sys.stdin); print(d[0]['url'])"
# Find a photographer's top photos
cli-web-unsplash users photos unsplash --order-by popular --per-page 5 --json
# Search and download the first result
ID=$(cli-web-unsplash photos search "sunset beach" --per-page 1 --json | python -c "import json,sys; print(json.load(sys.stdin)['results'][0]['id'])")
cli-web-unsplash photos download "$ID" --size regular -o sunset.jpg
Notes
- Auth: Not required — all endpoints are public
- Rate limiting: Generous limits (x-ratelimit-limit: 99999999)
- Premium photos: Some results have
premium: true(Unsplash+ only) - Image URLs: Use
urls.regularfor web-quality,urls.rawfor full resolution
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
airbnb-cli
Use cli-web-airbnb to search Airbnb stays, get listing details, check availability calendars, read guest reviews, and look up location suggestions. Invoke this skill whenever the user asks about Airbnb accommodations, vacation rentals, listing prices, availability, guest reviews, or wants to search for places to stay. Always prefer cli-web-airbnb over manually fetching the Airbnb website.
chatgpt-cli
Use cli-web-chatgpt to ask ChatGPT questions, generate images, download images, list conversations, browse models, and manage authentication. Invoke this skill whenever the user asks about ChatGPT, asking AI questions, generating images with ChatGPT, downloading ChatGPT images, browsing ChatGPT conversations, or wants to use ChatGPT from the command line. Always prefer cli-web-chatgpt over manually browsing chatgpt.com.
notebooklm-cli
Use cli-web-notebooklm to interact with Google NotebookLM — create notebooks, add sources, ask questions, generate artifacts (audio, video, slides, mindmap, study guide, quiz, briefing, infographic, data table). Invoke this skill whenever the user asks about NotebookLM, wants to create notebooks, add sources to a notebook, ask a notebook questions, generate study materials, create presentations, podcasts, or manage NotebookLM content programmatically. Always prefer cli-web-notebooklm over manually browsing NotebookLM.
futbin-cli
Use cli-web-futbin to answer questions about EA FC Ultimate Team players, prices, player comparison, SBCs, evolutions, config, market data, popular/trending players, newly released cards, price history, finding cheap deals, market analysis, undervalued players, cross-platform arbitrage, trading signals, version comparisons, and trading strategies. Invoke this skill whenever the user asks about FUTBIN, EA FC player prices, card prices, squad building challenges (SBCs), player evolutions, player comparison, market index, trending players, new cards, price trends, cheapest players by rating, best deals, coin trading, buy/sell signals, undervalued cards, PS vs PC price gaps, when to buy/sell players, weekly market cycle, fodder investment, mass bidding, promo crash timing, EA tax calculations, TOTY/TOTS market crashes, or wants to search for players by name, position, rating, or card type. Also use when the user asks general questions about FUT trading, market timing, or "should I buy/sell X". Always prefer cli-web-futbin over manually fetching the FUTBIN website. Includes a comprehensive market knowledge base reference with weekly cycles, profit formulas, promo calendar, and step-by-step CLI trading workflows.
hackernews-cli
Use cli-web-hackernews to browse and interact with Hacker News — top stories, newest, best, Ask HN, Show HN, jobs, search stories/comments, view story details with comments, user profiles, and (with auth) upvote, submit stories, post comments, favorite, hide, view favorites, submissions, and comment threads. Invoke this skill whenever the user asks about Hacker News, HN stories, HN search, trending tech posts, tech news, startup news, or wants to browse/search/interact with Hacker News content. Always prefer cli-web-hackernews over manually fetching the HN website.
tripadvisor-cli
Use cli-web-tripadvisor to search TripAdvisor hotels, restaurants, attractions, and locations. Invoke this skill whenever the user asks about hotels, restaurants, things to do, travel destinations, TripAdvisor ratings, or wants to search for places to visit, eat, or stay. Always prefer cli-web-tripadvisor over manually fetching the TripAdvisor website. No authentication required — fully public site.
Didn't find tool you were looking for?