unsplash-cli

unsplash-cli is a skill for Claude Code, Codex from ItamarZand88/CLI-Anything-WEB. It costs 94 tokens per session (813 once invoked), scanned A, original, MIT.

A command-line skill for finding and downloading free stock photos from Unsplash, a photo-sharing website. It also provides photo details, random photos, topics, collections, and photographer profiles.

In plain words
What is it for?
Use it to search by keyword, filter by orientation or colour, inspect EXIF and location data, browse collections or topics, view photographer portfolios, and save photos locally.
Why use it?
It removes the need to open Unsplash in a browser or write separate scripts for common photo searches and downloads.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/itamarzand88/cli-anything-web/unsplash-cli
Any agent
npx skills add ItamarZand88/CLI-Anything-WEB --skill unsplash-cli
Clone the repo
git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for unsplash-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/itamarzand88/cli-anything-web/unsplash-cli.svg)](https://agentmods.dev/skills/itamarzand88/cli-anything-web/unsplash-cli)
Your own site
<a href="https://agentmods.dev/skills/itamarzand88/cli-anything-web/unsplash-cli"><img src="https://agentmods.dev/badge/skills/itamarzand88/cli-anything-web/unsplash-cli.svg" alt="Measured on agentmods" height="20"></a>
Per session 94 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 813 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00094 $0.00813
Opus 5 $0.00047 $0.00407
Sonnet 5 $0.00019 $0.00163
Haiku 4.5 $0.00009 $0.00081

Measured 5d ago against content hash b43f87681521, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

unsplash-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/unsplash-cli/SKILL.md · 56 lines

How it starts

The opening of the file, as written. The whole thing — 56 lines — stays where its author put it; the contents beside it link to each section on GitHub.

cli-web-unsplash

Search, explore, and download Unsplash photos (read-only, no auth). Install: pip install cli-web-unsplash, then run python -m camoufox fetch once.

Commands

Command Purpose Key options
photos search QUERY Search photos --orientation landscape|portrait|squarish, --color, --order-by relevant|latest, --page, --per-page (max 30)
photos get PHOTO_ID Full details: EXIF, location, tags, URLs ID or slug
photos random Random photo(s) --query, --orientation, --count N (max 30)
photos download PHOTO_ID Download to disk --size raw|full|regular|small|thumb, -o/--output PATH
photos stats PHOTO_ID Views and downloads
topics list / topics get SLUG / topics photos SLUG Browse curated topics --page, --per-page, --order-by
collections search QUERY / collections get ID / collections photos ID Browse collections --page, --per-page
users search QUERY / users get USERNAME / users photos USERNAME / users collections USERNAME Photographer profiles and portfolios --page, --per-page, --order-by (photos: latest|oldest|popular|views|downloads)

Examples

# Search with filters (returns total, total_pages, results[] with id, likes, author, url)
cli-web-unsplash photos search "sunset" --orientation landscape --color orange --per-page 10 --json

# Photo details (EXIF, location, tags)
cli-web-unsplash photos get SyfvrXRy28Y --json

# Random nature photos
cli-web-unsplash photos random --query "nature" --count 3 --json

# Search then download the top hit
ID=$(cli-web-unsplash photos search "sunset beach" --per-page 1 --json | jq -r '.results[0].id')
cli-web-unsplash photos download "$ID" --size regular -o sunset.jpg

# A photographer's most popular photos
cli-web-unsplash users photos unsplash --order-by popular --per-page 5 --json

JSON output

Every command accepts --json and returns the data directly (search: {"total", "total_pages", "results": [...]}; download: {"photo_id", "size", "file", "bytes"}). Errors return {"error": true, "code": "...", "message": "..."}.

Read the full file on GitHub · 56 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 56 lines · 94 tokens per session scan A b43f87681521

Subscribe to this mod's changes

unsplash-cli is a skill published in the GitHub repository ItamarZand88/CLI-Anything-WEB (216 stars, last pushed 11d ago), licensed MIT. It adds 94 tokens to every session and 813 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gemini-imagegen

This skill should be used when generating and editing images using the Gemini API (Nano Banana Pro). It applies when creating images from text prompts, editing existing images, applying style transfers, generating logos with text, creating stickers, product mockups, or any image generation/manipulation task. Supports…

aegntic/compound-engineering · 81 tokens

skill-thought-partner

Brainstorm creatively with pattern spotting and paradox hunting — use for ideation and exploration.

nyldn/claude-octopus · 22 tokens

ffmpeg

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

digitalsamba/claude-code-video-toolkit · 55 tokens

playwright-recording

Record browser interactions as video using Playwright. Use for capturing demo videos, app walkthroughs, and UI flows for Remotion videos. Triggers include recording a demo, capturing browser video, screen recording a website, or creating walkthrough footage.

digitalsamba/claude-code-video-toolkit · 53 tokens

elevenlabs

Generate AI voiceovers, sound effects, and music using ElevenLabs APIs. Use when creating audio content for videos, podcasts, or games. Triggers include generating voiceovers, narration, dialogue, sound effects from descriptions, background music, soundtrack generation, voice cloning, or any audio synthesis task.

digitalsamba/claude-code-video-toolkit · 63 tokens

sheet-music-publisher

Converts mastered audio to sheet music and creates printable songbooks. Use after mastering when the user wants sheet music or a songbook for their album.

bitwize-music-studio/claude-ai-music-skills · 36 tokens