CLAUDE CODE MARKETPLACES

pixabay-footage

Search and download copyright-free images and video clips from Pixabay

npx skills add https://github.com/TeamWiseFlow/xiaobei --skill pixabay-footage
SKILL.md

Pixabay Footage — Pexels 之外的备选图片/视频素材

Use this skill when:

  • Pexels results are not suitable or quota is exhausted
  • You need alternative copyright-free images or video clips
  • Preparing visual assets for content creation

Prerequisites: PIXABAY_API_KEY must be set. Register free at https://pixabay.com/api/docs/


Usage

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

下载图片

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

下载视频

pixabay-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 精确匹配所需时长,不要下载远超需求的素材。

Same interface as pexels-footage. Output format identical.


When to Choose Pixabay vs Pexels

PixabayPexels
Photo qualityGoodHigh
Photo count4M+3M+
Video qualityGood (HD)Higher (HD/4K)
Video count2M+1M+
Rate limits100 req/min (free)200 req/hour (free)
Best forObjects, abstract, conceptsPeople, nature, lifestyle

Pexels is the primary footage source (higher quality). Fall back to Pixabay if Pexels results are insufficient or rate-limited.


Options

OptionDefaultDescription
--termsrequiredComma-separated search keywords (one per scene)
--typevideoimage or video
--aspect9:169:16 (portrait) | 16:9 (landscape) | 1:1 (square)
--output-dirrequiredDirectory to save downloaded files
--min-duration5Minimum clip duration in seconds (video only)
--max-durationnoneMaximum clip duration in seconds (video only). 强烈建议设置,避免下载过长的素材
--max-clips1 (video) / 15 (image)Maximum total files to download. 视频类型强制为 1

Output

Same JSON structure as pexels-footage:

  • --type image{"ok": true, "images": [...], "total": N, "output_dir": "..."}
  • --type video{"ok": true, "clips": [...], "total": N, "output_dir": "..."}

Environment Variables

VariableDescription
PIXABAY_API_KEYPixabay API key (required)
Installs0
GitHub Stars8.5k
LanguagePython
AddedAug 29, 2026
View on GitHub