image-search

1. 多维度过滤：按尺寸、颜色、类型（照片/插画/GIF）筛选
2. 版权筛选：支持按授权类型过滤图片
3. 自动下载：可将图片下载到本地目录
4. 结构化输出：返回图片元数据便于后续处理

步骤 1：运行搜索脚本

```bash

python scripts/image_search.py "搜索关键词" --max_results 10 --size Large

```

参数说明：

• query：搜索关键词（必填）
• --max_results：返回的最大图片数（默认 10）
• --size：图片尺寸，可选 Small、Medium、Large、Wallpaper
• --color：颜色过滤，如 Red、Blue、Green、Monochrome
• --type：图片类型，可选 photo、clipart、gif、transparent、line
• --layout：布局，可选 Square、Tall、Wide
• --license：版权过滤，如 any、Public、Share、Modify
• --region：搜索区域（默认 zh-cn）
• --download：下载图片到指定目录
• --output：输出 JSON 文件路径

步骤 2：查看搜索结果

脚本会输出 JSON 格式的结果：

```json

{

"query": "科技插图",

"timestamp": "2026-01-21T10:30:00",

"total_results": 10,

"results": [

{

"title": "科技未来城市插图",

"image": "https://example.com/image.jpg",

"thumbnail": "https://example.com/thumb.jpg",

"url": "https://example.com/page",

"source": "example.com",

"width": 1920,

"height": 1080,

"local_path": "./images/image_001.jpg"

}

]

}

```

步骤 3：下载图片（可选）

使用 --download 参数自动下载图片到本地：

```bash

python scripts/image_search.py "风景摄影" --download ./images --max_results 5

```

下载的图片会按顺序命名：image_001.jpg、image_002.png 等。

关键词优化

对于内容配图，建议使用描述性关键词：

• ❌ "AI" → 结果太泛
• ✅ "AI 机器人 未来科技 插图" → 更精准

尺寸选择建议

| 用途 | 推荐尺寸 |

| ----------- | ----------------- |

| 文章头图 | Large / Wallpaper |

| 正文配图 | Medium / Large |

| 缩略图 | Small / Medium |

| 横幅 Banner | Wide + Large |

颜色搭配

根据文章主题选择配色：

• 科技类：Blue、Monochrome
• 自然类：Green
• 警示类：Red、Orange
• 简约风：Monochrome

搜索到图片后，可以使用 [图片处理 Skill](../image-processing/SKILL.md) 进行：

• 添加文字标注
• 插入配文（底部边框/内部贴纸）
• 调整尺寸

1. 网络要求：需要能够访问 DuckDuckGo 图片搜索服务
2. 版权合规：下载图片前请确认版权许可，商业用途需特别注意
3. 下载限流：自动下载会有适当延迟，避免触发限制
4. 图片有效性：部分图片 URL 可能失效，脚本会自动跳过并报告