pexels-footage

Search and download copyright-free images and video clips from Pexels API. Supports both photo search (--type image) and video search (--type video, default).

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/pexels-footage/SKILL.md

Pexels Footage — 版权免费图片/视频素材下载

Use this skill when:

You need real photos or video clips (not AI-generated) as source material
User wants professional-looking footage or images from Pexels
Preparing visual assets for content creation

Prerequisites: PEXELS_API_KEY must be set. Register free at https://www.pexels.com/api/

Usage

通过 PATH 调用 wrapper，无需拼接脚本路径。

下载图片

pexels-footage \
  --type image \
  --terms "sunset ocean,mountain landscape,forest path" \
  --aspect 16:9 \
  --output-dir ./assets/images \
  [--max-clips 15]

下载视频

pexels-footage \
  --type video \
  --terms "sunset ocean" \
  --aspect 9:16 \
  --output-dir ./video_assets/footage \
  --min-duration 5 \
  --max-duration 30

重要：视频下载一次只允许下载一个（脚本已强制 --max-clips=1），不允许批量下载。下载时应根据 content-check 报告的时长缺口，通过 --min-duration 和 --max-duration 精确匹配所需时长，不要下载远超需求的素材。

Options

Option	Default	Description
`--terms`	required	Comma-separated search keywords (one per scene)
`--type`	`video`	`image` or `video`
`--aspect`	`9:16`	`9:16` (portrait) \| `16:9` (landscape) \| `1:1` (square)
`--output-dir`	required	Directory to save downloaded files
`--min-duration`	`5`	Minimum clip duration in seconds (video only)
`--max-duration`	none	Maximum clip duration in seconds (video only). 强烈建议设置，避免下载过长的素材
`--max-clips`	`1` (video) / `15` (image)	Maximum total files to download. 视频类型强制为 1

Output

图片输出

✅ Downloaded 12 images to ./assets/images/
   pexels-sunset-ocean-abc123.jpg  (1920x1280)
   pexels-mountain-def456.jpg      (2048x1365)
   ...

Returns JSON to stdout:

{
  "ok": true,
  "images": ["path1.jpg", "path2.jpg"],
  "total": 12,
  "output_dir": "./assets/images"
}

视频输出

{
  "ok": true,
  "clips": ["path1.mp4", "path2.mp4"],
  "total": 12,
  "output_dir": "./video_assets/footage"
}

Environment Variables

Variable	Description
`PEXELS_API_KEY`	Pexels API key (required)

Error Handling

Error	Action
`PEXELS_API_KEY not set`	Check environment variables
No results found for term	Try broader/simpler keywords (English works best)
Download fails	Retry once; skip if fails again
Rate limit (HTTP 429)	Wait 60s, then retry

Repository: TeamWiseFlow/xiaobei
Path: skills/pexels-footage/SKILL.md
Commit: bcef823

Last updated: 3 days ago
First committed: 20 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.