Pexels

Pexels

Fetches real, royalty-free stock photos from the Pexels API for use as placeholder, demo, or seed content. Never fabricate photo URLs — always fetch from the live API via this skill.

Usage

bash ~/.claude/skills/pexels/scripts/search.sh "search query" [count] [orientation]

• query (required): search term, e.g. "surfing sunset beach".
• count (optional, default 10, max 80): number of results.
• orientation (optional): landscape, portrait, or square.

Returns JSON: { total_results, photos: [{ id, photographer, url, src: { large, original, medium } }] }.

Run one search per distinct visual theme needed (e.g. separate calls for "yoga sunrise cliff" vs "surf sunset beach") rather than one broad query, so results stay relevant per use case.

Notes

• src.large (~940px wide) is the right default for web use; src.original is full resolution, src.medium for thumbnails.
• Images are served from images.pexels.com. If hotlinking directly in a Next.js <Image> component, that hostname must be added to the project's next.config's images.remotePatterns or rendering will fail.
• Attribution isn't legally required by Pexels but is appreciated — use photographer from the response if crediting in UI.
• Requires the PEXELS_API_KEY env var (free key: https://www.pexels.com/api/). Never hardcode it into this script.