Brave Images

通过 curl 调用 Brave Search API 的图片搜索端点，支持 q、count、country、search_lang、safesearch 参数，需要 BRAVE_API_KEY；解析响应中的标题、原图 URL、缩略图与尺寸字段，并直接把图片连同标题呈现给用户，可提示是否查看更多结果。

zats

热度 94.63

最近更新 2026-05-11 15:50:52

分类：搜索依赖：第三方 API / 代码执行应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add brave-images

Metadata

name: brave-images
description: Search for images using Brave Search API. Use when you need to find images, pictures, photos, or visual content on any topic. Requires BRAVE_API_KEY environment variable.

Brave Image Search

Search images via Brave Search API.

Usage

curl -s "https://api.search.brave.com/res/v1/images/search?q=QUERY&count=COUNT" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Parameters

Param	Required	Description
`q`	yes	Search query (URL-encoded)
`count`	no	Results count (1-100, default 20)
`country`	no	2-letter code (US, DE, IL) for region bias
`search_lang`	no	Language code (en, de, he)
`safesearch`	no	off, moderate, strict (default: moderate)

Response Parsing

Key fields in each result:

results[].title — Image title
results[].properties.url — Full image URL
results[].thumbnail.src — Thumbnail URL
results[].source — Source website
results[].properties.width/height — Dimensions

Example

Search for "sunset beach" images in Israel:

curl -s "https://api.search.brave.com/res/v1/images/search?q=sunset%20beach&count=5&country=IL" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Then extract from JSON response:

Thumbnail: .results[0].thumbnail.src
Full image: .results[0].properties.url

Delivering Results

When presenting image search results:

Send images directly to the user (don't just list URLs)
Use results[].properties.url for full images or results[].thumbnail.src for thumbnails
Include image title as caption
If more results exist than shown, tell the user (e.g., "Found 20 images, showing 3 — want more?")

Example flow:

User: "find me pictures of sunsets"
→ Search with count=10
→ Send 3-5 images with captions
→ "Found 10 sunset images, showing 5. Want to see more?"

Notes

URL-encode query strings (spaces → %20)
API key from env: $BRAVE_API_KEY
Respect rate limits per subscription tier