← Back to Skills Marketplace
2847
Downloads
4
Stars
6
Active Installs
2
Versions
Install in OpenClaw
/install 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.
README (SKILL.md)
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 titleresults[].properties.url— Full image URLresults[].thumbnail.src— Thumbnail URLresults[].source— Source websiteresults[].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.urlfor full images orresults[].thumbnail.srcfor 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
Usage Guidance
Before installing: (1) Confirm the skill actually requires and will use BRAVE_API_KEY — the SKILL.md mentions it but the registry metadata does not; prefer skills whose metadata declares required env vars and primary credential. (2) Only supply a Brave API key you control and consider a restricted/monitoring-only key (not a broad production key). (3) Be aware the agent may fetch image bytes from external URLs (outbound downloads), which can expose your environment to remote content — if you need to limit risk, run in a sandbox or block automatic image fetching. (4) If you cannot verify the publisher/source (homepage unknown), ask the publisher to update the registry entry to list BRAVE_API_KEY as a required/primary credential or provide provenance; otherwise treat it cautiously. (5) If the metadata is corrected to explicitly require BRAVE_API_KEY and designate it as the primary credential, the mismatch concern would be resolved and my assessment would lean toward benign.
Capability Analysis
Type: OpenClaw Skill
Name: brave-images
Version: 1.0.1
The skill bundle is designed to search for images using the Brave Search API. It explicitly requires and uses the `$BRAVE_API_KEY` environment variable to authenticate with the legitimate `api.search.brave.com` endpoint, as shown in SKILL.md. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution, persistence mechanisms, or prompt injection attempts to subvert the agent's intended behavior. All instructions and code snippets are directly related to its stated purpose of image searching.
Capability Assessment
Purpose & Capability
SKILL.md clearly implements Brave image search (curl to api.search.brave.com with X-Subscription-Token). That capability is coherent with the name/description. However, the skill text requires a BRAVE_API_KEY environment variable while the registry metadata lists no required env vars and no primary credential — this mismatch is unexpected and disproportionate.
Instruction Scope
Runtime instructions are narrowly scoped to calling the Brave Images endpoint, parsing the JSON response, and presenting images. They do not request reading local files or unrelated environment variables. Note: the SKILL.md instructs the agent to 'send images directly' which implies fetching image bytes from external URLs (normal for an image search skill but worth being aware of because it causes outbound downloads).
Install Mechanism
This is an instruction-only skill with no install spec or code files, so nothing will be written to disk by an installer. That is the lowest-risk installation model.
Credentials
Requesting a single BRAVE_API_KEY is proportionate to a Brave Search integration. The concern is that the manifest/registry metadata did not declare this required env var nor mark it as the primary credential — an inconsistency that could hide needed setup steps or cause confusion about where to place credentials. Verify what the agent platform expects and that the key will not be shared beyond this skill.
Persistence & Privilege
The skill is not marked always:true and uses normal model invocation. It does not request persistent system-wide changes or modify other skills' configs. No elevated persistence or privilege is requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install brave-images - After installation, invoke the skill by name or use
/brave-images - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Added delivery guidance for showing images to users
v1.0.0
Initial release: Brave Image Search API skill
Metadata
Frequently Asked Questions
What is Brave Images?
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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2847 downloads so far.
How do I install Brave Images?
Run "/install brave-images" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Brave Images free?
Yes, Brave Images is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Brave Images support?
Brave Images is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Brave Images?
It is built and maintained by zats (@zats); the current version is v1.0.1.
More Skills