🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Brave Images
πŸ¦€ ClawHub

Brave Images

by @zats

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.

Versionv1.0.1
Downloads3,185
Installs6
Stars⭐ 4
#clawhub
TERMINAL
clawhub install brave-images

πŸ“– About This Skill

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: 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

    • πŸ’‘ Examples

    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

    • πŸ“‹ Tips & Best Practices

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