pexels-image-downloader

# Pexels图片下载技能

使用Pexels API搜索和下载高质量的免费图片，支持自动调整尺寸、格式验证和元数据管理。特别适合小红书、社交媒体等内容创作。

## 🎯 核心功能

- ✅ **高质量图片**：专业摄影师作品，非AI生成
- ✅ **免费商业使用**：Pexels免费许可，可商用
- ✅ **智能搜索**：多关键词搜索，自动选择最佳图片
- ✅ **尺寸调整**：自动调整到目标尺寸（如小红书1242x1660）
- ✅ **格式验证**：验证图片格式、尺寸、文件大小
- ✅ **元数据管理**：保存图片信息和许可条款

## 🔑 快速开始

### 1. 获取Pexels API密钥
1. 访问 [Pexels官网](https://www.pexels.com/api/)
2. 注册免费账号
3. 获取API密钥

### 2. 基本使用
```bash
# 设置API密钥
export PEXELS_API_KEY="your_api_key_here"

# 搜索并下载图片
python download_pexels.py --query "sculpture art" --size 1242x1660

# 批量下载
python download_pexels.py --query-file keywords.txt --count 5 --output-dir images/
```

## 📦 安装

```bash
# 安装依赖
pip install requests pillow

# 或使用requirements.txt
pip install -r requirements.txt
```

## 📁 项目结构

```
pexels-image-downloader/
├── SKILL.md                    # 本文档
├── download_pexels.py          # 主下载脚本
├── requirements.txt            # Python依赖
├── config/
│   ├── default_config.json     # 默认配置
│   └── image_sizes.json        # 平台尺寸配置
├── scripts/
│   ├── batch_download.sh       # 批量下载脚本
│   ├── resize_images.py        # 图片调整脚本
│   └── validate_images.py      # 图片验证脚本
├── examples/
│   ├── xiaohongshu_example.py  # 小红书示例
│   └── social_media_example.py # 社交媒体示例
└── docs/
    ├── api_reference.md        # API参考
    └── best_practices.md       # 最佳实践
```

## 🚀 核心功能详解

### 1. 智能图片搜索
```python
# 多关键词搜索，自动选择最佳图片
python download_pexels.py \
  --query "sculpture art;clay sculpture;art studio" \
  --orientation portrait \
  --size large \
  --color any
```

### 2. 平台专用尺寸
```bash
# 小红书尺寸
python download_pexels.py --query "art" --platform xiaohongshu

# 微信尺寸  
python download_pexels.py --query "food" --platform w...