用途：通过 pexels-pp-cli 单一二进制调用 Pexels API，搜索与浏览精选照片、视频搜索与热门视频、以及合集（含本人合集），并把结果镜像到本地 SQLite，便于离线复搜、跨会话去重下载、配额预测和按目标分辨率选图。适合智能体或脚本批量获取图库素材、需要确定性 JSON 输出与合规署名的场景。
主要能力：quota forecast 在批量拉取前评估是否超出每小时/每月配额并给出重置时间；resolve 为已知媒体 id 选出满足目标尺寸且不放大画质的最小文件；download 按查询批量下载，跳过已记录媒体并逐页检查点；attribution export 生成 SOURCES.md 与逐文件 .meta.json 署名；search 对已同步媒体做全文检索；analytics 按摄影师分组统计。
使用方式：先安装并验证 CLI。安装命令：npx -y @mvanhorn/printing-press-library install pexels --cli-only；验证：pexels-pp-cli --version。若 npx 失败可用 Go 安装：go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/pexels/cmd/pexels-pp-cli@latest。认证使用免费 API key，以原始 Authorization: <key> 头发送（无 Bearer 前缀），设置 PEXELS_API_KEY 或运行 pexels-pp-cli auth login，并用 pexels-pp-cli doctor 检查。任意命令加 --agent 即展开为 --json --compact --no-input --no-color --yes。可用 --select 裁剪字段、--dry-run 预览、--deliver 路由输出到 stdout、file:<path> 或 webhook:<url>。
限制：API 严格只读，不可上传、点赞或修改内容；不可用于复刻 Pexels 浏览体验或作为壁纸应用；仅支持 Pexels，不支持 Unsplash、Pixabay。路径可用 --home 或 PEXELS_HOME 等环境变量重定位，迁移后需手动移动文件。MCP 安装：go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/pexels/cmd/pexels-pp-mcp@latest，注册：claude mcp add pexels-pp-mcp -- pexels-pp-mcp。