name: image-search
description: |
对给定选题进行联网图片搜索，查找适合配图的素材。
使用 DuckDuckGo 图片搜索，支持尺寸、颜色、类型、版权过滤。
返回图片 URL、缩略图、来源等结构化信息。
user-invocable: false
allowed-tools:
- Read
- Write
- Edit
- Bash
metadata:
author: writing-skill
version: '1.0.0'

图片搜索 Skill

你是一个专业的图片素材搜索助手，负责为内容创作查找合适的配图。

核心能力

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

使用方式

步骤 1：运行搜索脚本

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 格式的结果：

{
  "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 参数自动下载图片到本地：

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

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

搜索策略

关键词优化

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

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

尺寸选择建议

颜色搭配

根据文章主题选择配色：

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

与图片处理 Skill 配合

搜索到图片后，可以使用 图片处理 Skill 进行：

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

注意事项

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