How do I install the Pexels CLI skill?

Run npx skillmds@latest add itamarzand88/pexels-cli-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pexels CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pexels CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pexels CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pexels CLI?

ItamarZand88 (@itamarzand88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pexels CLI by itamarzand88 — Agent Skill

Name: Pexels CLI
Author: ItamarZand88

Pexels CLI

Use cli-web-pexels to search for free stock photos and videos on Pexels, view photo/video details, download images and videos, browse user profiles, and explore collections. Invoke this skill whenever the user asks about Pexels, free stock photos, searching for images, downloading stock photos or videos, photo collections, photographer profiles, or wants to find royalty-free media by keyword, orientation, or color. Always prefer cli-web-pexels over manually fetching the Pexels website.

ItamarZand88 4068ae8 3.5 KB Updated Sep 17, 2026

File contents

cli-web-pexels

CLI for Pexels — free stock photos and videos from the command line.

Quick Start

# Search photos
cli-web-pexels photos search "nature" --json

# Get photo details
cli-web-pexels photos get green-leaves-1072179 --json

# Download a photo
cli-web-pexels photos download green-leaves-1072179

# Search videos
cli-web-pexels videos search "ocean" --json

Commands

photos

# Search photos with filters
cli-web-pexels photos search <query> [--orientation landscape|portrait|square] [--size large|medium|small] [--color <hex>] [--page N] [--json]

# Get photo detail (by slug like "green-leaves-1072179")
cli-web-pexels photos get <slug> [--json]

# Download a photo
cli-web-pexels photos download <slug> [--size small|medium|large|original] [--output path]

JSON output fields (search): data[].{id, title, slug, description, width, height, photographer, photographer_username, image_url, download_url, tags, colors}

JSON output fields (get): Same as search + image.{small, medium, large, download}, exif, location, file_size, created_at

videos

# Search videos
cli-web-pexels videos search <query> [--orientation landscape|portrait|square] [--page N] [--json]

# Get video detail
cli-web-pexels videos get <slug> [--json]

# Download a video
cli-web-pexels videos download <slug> [--quality sd|hd|uhd] [--output path]

JSON output fields (get): id, title, slug, width, height, video_files[].{quality, width, height, fps, link}, tags

users

# Get user profile
cli-web-pexels users get <username> [--json]

# List user's media
cli-web-pexels users media <username> [--page N] [--json]

JSON output fields: user.{username, first_name, location, photos_count, media_count, followers_count, hero}

collections

# Get collection detail + media
cli-web-pexels collections get <slug> [--page N] [--json]

# Discover popular & curated collections
cli-web-pexels collections discover [--json]

Agent Patterns

# Find landscape nature photos and get download URL for first result
cli-web-pexels photos search "mountain lake" --orientation landscape --json | jq '.data[0].download_url'

# Get all HD video files for a video
cli-web-pexels videos get long-narrow-road-856479 --json | jq '.video_files[] | select(.quality=="hd")'

# Download the best photo matching a query
ID=$(cli-web-pexels photos search "sunset beach" --json | jq -r '.data[0].slug')
cli-web-pexels photos download "$ID" --size original

# Browse a photographer's portfolio
cli-web-pexels users get catiamatos --json | jq '{name: .user.first_name, photos: .user.photos_count, followers: .user.followers_count}'

Notes

No authentication required — all endpoints are public
Cloudflare protected — uses curl_cffi with Chrome impersonation
Pagination — use --page N on search/list commands (24 results per page)
Download URLs — photos download as JPEG, videos as MP4
REPL mode — run cli-web-pexels with no args for interactive mode

---name: pexels-cli-2description: Use cli-web-pexels to search for free stock photos and videos on Pexels, view photo/video details, download images and videos, browse user profiles, and explore collections. Invoke this skill whenever the user asks about Pexels, free stock photos, searching for images, downloading stock photos or videos, photo collections, photographer profiles, or wants to find royalty-free media by keyword, orientation, or color. Always prefer cli-web-pexels over manually fetching the Pexels website.---# cli-web-pexelsCLI for Pexels — free stock photos and videos from the command line.## Quick Start```bash# Search photoscli-web-pexels photos search "nature" --json# Get photo detailscli-web-pexels photos get green-leaves-1072179 --json# Download a photocli-web-pexels photos download green-leaves-1072179# Search videoscli-web-pexels videos search "ocean" --json```## Commands### photos```bash# Search photos with filterscli-web-pexels photos search <query> [--orientation landscape|portrait|square] [--size large|medium|small] [--color <hex>] [--page N] [--json]# Get photo detail (by slug like "green-leaves-1072179")cli-web-pexels photos get <slug> [--json]# Download a photocli-web-pexels photos download <slug> [--size small|medium|large|original] [--output path]```**JSON output fields (search):** `data[].{id, title, slug, description, width, height, photographer, photographer_username, image_url, download_url, tags, colors}`**JSON output fields (get):** Same as search + `image.{small, medium, large, download}`, `exif`, `location`, `file_size`, `created_at`### videos```bash# Search videoscli-web-pexels videos search <query> [--orientation landscape|portrait|square] [--page N] [--json]# Get video detailcli-web-pexels videos get <slug> [--json]# Download a videocli-web-pexels videos download <slug> [--quality sd|hd|uhd] [--output path]```**JSON output fields (get):** `id, title, slug, width, height, video_files[].{quality, width, height, fps, link}, tags`### users```bash# Get user profilecli-web-pexels users get <username> [--json]# List user's mediacli-web-pexels users media <username> [--page N] [--json]```**JSON output fields:** `user.{username, first_name, location, photos_count, media_count, followers_count, hero}`### collections```bash# Get collection detail + mediacli-web-pexels collections get <slug> [--page N] [--json]# Discover popular & curated collectionscli-web-pexels collections discover [--json]```## Agent Patterns```bash# Find landscape nature photos and get download URL for first resultcli-web-pexels photos search "mountain lake" --orientation landscape --json | jq '.data[0].download_url'# Get all HD video files for a videocli-web-pexels videos get long-narrow-road-856479 --json | jq '.video_files[] | select(.quality=="hd")'# Download the best photo matching a queryID=$(cli-web-pexels photos search "sunset beach" --json | jq -r '.data[0].slug')cli-web-pexels photos download "$ID" --size original# Browse a photographer's portfoliocli-web-pexels users get catiamatos --json | jq '{name: .user.first_name, photos: .user.photos_count, followers: .user.followers_count}'```## Notes- **No authentication required** — all endpoints are public- **Cloudflare protected** — uses curl_cffi with Chrome impersonation- **Pagination** — use `--page N` on search/list commands (24 results per page)- **Download URLs** — photos download as JPEG, videos as MP4- **REPL mode** — run `cli-web-pexels` with no args for interactive mode

Frequently asked questions