brave-images

✓Verified·Scanned 2/19/2026

This skill searches images via the https://api.search.brave.com/res/v1/images/search API and returns images with captions. It requires the BRAVE_API_KEY environment variable and makes outbound calls to Brave Search; no other sensitive or obfuscated behaviors are present.

from clawhub.ai·v71ae194·2.0 KB·0 installs
Scanned from 1.0.1 at 71ae194 · Transparency log ↗
$ vett add clawhub.ai/zats/brave-images

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

ParamRequiredDescription
qyesSearch query (URL-encoded)
countnoResults count (1-100, default 20)
countryno2-letter code (US, DE, IL) for region bias
search_langnoLanguage code (en, de, he)
safesearchnooff, 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:

  1. Send images directly to the user (don't just list URLs)
  2. Use results[].properties.url for full images or results[].thumbnail.src for thumbnails
  3. Include image title as caption
  4. 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