image-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

图片搜索 Skill

Image Search Skill

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

You are a professional image material search assistant, responsible for finding suitable images for content creation.

核心能力

Core Capabilities

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

Multi-dimensional filtering: Filter by size, color, type (photo/illustration/GIF)
Copyright filtering: Support filtering images by license type
Automatic download: Can download images to local directories
Structured output: Return image metadata for subsequent processing

使用方式

Usage

步骤 1：运行搜索脚本

Step 1: Run the search script

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 文件路径

bash

python scripts/image_search.py "search keyword" --max_results 10 --size Large

Parameter Description:

```
query
```
: Search keyword (required)
```
--max_results
```
: Maximum number of images to return (default 10)
```
--size
```
: Image size, optional values:
```
Small
```
,
```
Medium
```
,
```
Large
```
,
```
Wallpaper
```
```
--color
```
: Color filtering, e.g.,
```
Red
```
,
```
Blue
```
,
```
Green
```
,
```
Monochrome
```
```
--type
```
: Image type, optional values:
```
photo
```
,
```
clipart
```
,
```
gif
```
,
```
transparent
```
,
```
line
```
```
--layout
```
: Layout, optional values:
```
Square
```
,
```
Tall
```
,
```
Wide
```
```
--license
```
: Copyright filtering, e.g.,
```
any
```
,
```
Public
```
,
```
Share
```
,
```
Modify
```
```
--region
```
: Search region (default
```
zh-cn
```
)
```
--download
```
: Download images to the specified directory
```
--output
```
: Output JSON file path

步骤 2：查看搜索结果

Step 2: View search results

脚本会输出 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"
    }
  ]
}

The script will output results in JSON format:

json

{
  "query": "technology illustration",
  "timestamp": "2026-01-21T10:30:00",
  "total_results": 10,
  "results": [
    {
      "title": "Future Technology City Illustration",
      "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：下载图片（可选）

Step 3: Download images (optional)

使用

--download

参数自动下载图片到本地：

bash

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

下载的图片会按顺序命名：

image_001.jpg

、

image_002.png

等。

Use the

--download

parameter to automatically download images to the local directory:

bash

python scripts/image_search.py "landscape photography" --download ./images --max_results 5

Downloaded images will be named sequentially:

image_001.jpg

image_002.png

, etc.

搜索策略

Search Strategies

关键词优化

Keyword Optimization

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

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

For content images, it is recommended to use descriptive keywords:

❌ "AI" → Too broad results
✅ "AI robot future technology illustration" → More precise

尺寸选择建议

Size Selection Recommendations

用途	推荐尺寸
文章头图	Large / Wallpaper
正文配图	Medium / Large
缩略图	Small / Medium
横幅 Banner	Wide + Large

Usage	Recommended Size
Article header	Large / Wallpaper
Body image	Medium / Large
Thumbnail	Small / Medium
Banner	Wide + Large

颜色搭配

Color Matching

根据文章主题选择配色：

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

Choose colors based on the article theme:

Technology category: Blue, Monochrome
Nature category: Green
Warning category: Red, Orange
Minimalist style: Monochrome

与图片处理 Skill 配合

Cooperation with Image Processing Skill

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

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

After searching for images, you can use the Image Processing Skill to:

Add text annotations
Insert captions (bottom border/internal stickers)
Adjust size

注意事项

Notes

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

Network requirements: Need access to DuckDuckGo Image Search service
Copyright compliance: Please confirm copyright permission before downloading images, especially for commercial use
Download rate limiting: Automatic downloads will have appropriate delays to avoid triggering restrictions
Image validity: Some image URLs may be invalid, the script will automatically skip and report them