mcpField
I
image-search

image-search

github.com/z0gsh1uCreative & media34230 installsUpdated 34w ago
Repository

About image-search

image-search is a skill for finding images for content creation. Its script filters by visual properties and license, returns structured metadata, and can download selected results locally.

Key features

  1. 01Filter by size, color, type, and layout
  2. 02Filter results by license
  3. 03Download images to a local directory
  4. 04Save structured results as JSON

Use cases

  1. 01Find a large image for an article header
  2. 02Search for images matching a chosen palette
  3. 03Download image assets for a content project

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/z0gsh1u/oh-my-writing-skill --skill image-search

After installing, type/image-searchin Claude Code to confirm it loaded.

Bundled filesscripts/image_search.py

Details

From the project README

图片搜索 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 机器人 未来科技 插图" → 更精准
尺寸选择建议
用途推荐尺寸
文章头图Large / Wallpaper
正文配图Medium / Large
缩略图Small / Medium
横幅 BannerWide + Large
颜色搭配

根据文章主题选择配色:

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

与图片处理 Skill 配合

搜索到图片后,可以使用 图片处理 Skill 进行:

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

注意事项

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

Comments

Markdown supported