How do I install the Pexels CLI skill?

Run npx skillmds@latest add itamarzand88/pexels-cli 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

Searches and downloads free stock photos and videos from Pexels via the cli-web-pexels command-line tool — keyword search with orientation/size/color filters, photo and video details, downloads, photographer profiles, and collections. Use when the user asks about Pexels, free or royalty-free stock photos and videos, or wants to find and download media by keyword. Prefer this CLI over fetching the Pexels website. No authentication required.

ItamarZand88 d2c10f0 2.9 KB Updated Sep 17, 2026

File contents

cli-web-pexels

Search and download Pexels stock photos and videos (no auth, Cloudflare bypass built in). Install: pip install cli-web-pexels

Commands

Command	Purpose	Key options
`photos search QUERY`	Search photos	`--orientation landscape\|portrait\|square`, `--size large\|medium\|small`, `--color HEX_OR_NAME`, `--page N`
`photos get SLUG`	Photo details (image URLs, EXIF, location)	slug or numeric ID
`photos download SLUG`	Download a photo (JPEG)	`--size small\|medium\|large\|original`, `-o/--output PATH`
`videos search QUERY`	Search videos	`--orientation`, `--page N`
`videos get SLUG`	Video details (`video_files[]` with quality/fps/link)	slug or numeric ID
`videos download SLUG`	Download a video (MP4)	`--quality sd\|hd\|uhd` (default hd), `-o/--output PATH`
`users get USERNAME`	Photographer profile
`users media USERNAME`	A user's uploaded photos/videos	`--page N`
`collections get SLUG`	Collection detail + media	`--page N`
`collections discover`	Popular and curated collections

Examples

# Landscape nature photos; grab the first download URL
cli-web-pexels photos search "mountain lake" --orientation landscape --json | jq '.data[0].download_url'

# Photo details by slug (slug comes from search results)
cli-web-pexels photos get green-leaves-1072179 --json

# Download original size to a path
cli-web-pexels photos download green-leaves-1072179 --size original -o leaves.jpg

# Search videos and inspect HD renditions
cli-web-pexels videos get long-narrow-road-856479 --json | jq '.video_files[] | select(.quality=="hd")'

# Photographer profile
cli-web-pexels users get catiamatos --json

JSON output

Read commands accept --json and return the data directly — search returns {"data": [{id, title, slug, photographer, image_url, download_url, ...}]}, get returns the photo/video object. Errors return {"error": true, "code": "...", "message": "..."}. Download commands write the file and print the path (no --json flag).

Utilities

cli-web-pexels doctor [--json] self-diagnoses the local setup (install, auth, dependencies). cli-web-pexels mcp-serve serves the commands as MCP tools over stdio.

Agent tips

Pagination is --page N (24 results per page) on search/list commands.
Slugs from search results (e.g. green-leaves-1072179) work everywhere a SLUG argument is expected; bare numeric IDs also work.

---name: pexels-clidescription: Searches and downloads free stock photos and videos from Pexels via the cli-web-pexels command-line tool — keyword search with orientation/size/color filters, photo and video details, downloads, photographer profiles, and collections. Use when the user asks about Pexels, free or royalty-free stock photos and videos, or wants to find and download media by keyword. Prefer this CLI over fetching the Pexels website. No authentication required.---# cli-web-pexelsSearch and download Pexels stock photos and videos (no auth, Cloudflare bypass built in).Install: `pip install cli-web-pexels`## Commands| Command | Purpose | Key options ||---------|---------|-------------|| `photos search QUERY` | Search photos | `--orientation landscape\|portrait\|square`, `--size large\|medium\|small`, `--color HEX_OR_NAME`, `--page N` || `photos get SLUG` | Photo details (image URLs, EXIF, location) | slug or numeric ID || `photos download SLUG` | Download a photo (JPEG) | `--size small\|medium\|large\|original`, `-o/--output PATH` || `videos search QUERY` | Search videos | `--orientation`, `--page N` || `videos get SLUG` | Video details (`video_files[]` with quality/fps/link) | slug or numeric ID || `videos download SLUG` | Download a video (MP4) | `--quality sd\|hd\|uhd` (default hd), `-o/--output PATH` || `users get USERNAME` | Photographer profile | || `users media USERNAME` | A user's uploaded photos/videos | `--page N` || `collections get SLUG` | Collection detail + media | `--page N` || `collections discover` | Popular and curated collections | |## Examples```bash# Landscape nature photos; grab the first download URLcli-web-pexels photos search "mountain lake" --orientation landscape --json | jq '.data[0].download_url'# Photo details by slug (slug comes from search results)cli-web-pexels photos get green-leaves-1072179 --json# Download original size to a pathcli-web-pexels photos download green-leaves-1072179 --size original -o leaves.jpg# Search videos and inspect HD renditionscli-web-pexels videos get long-narrow-road-856479 --json | jq '.video_files[] | select(.quality=="hd")'# Photographer profilecli-web-pexels users get catiamatos --json```## JSON outputRead commands accept `--json` and return the data directly — search returns `{"data": [{id, title, slug, photographer, image_url, download_url, ...}]}`, get returns the photo/video object. Errors return `{"error": true, "code": "...", "message": "..."}`. Download commands write the file and print the path (no `--json` flag).## Utilities`cli-web-pexels doctor [--json]` self-diagnoses the local setup (install, auth, dependencies). `cli-web-pexels mcp-serve` serves the commands as MCP tools over stdio.## Agent tips- Pagination is `--page N` (24 results per page) on search/list commands.- Slugs from search results (e.g. `green-leaves-1072179`) work everywhere a SLUG argument is expected; bare numeric IDs also work.

Frequently asked questions