← 返回 Skills 市场
2847
总下载
4
收藏
6
当前安装
2
版本数
在 OpenClaw 中安装
/install 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.
使用说明 (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
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install brave-images - 安装完成后，直接呼叫该 Skill 的名称或使用
/brave-images触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
Added delivery guidance for showing images to users
v1.0.0
Initial release: Brave Image Search API skill
元数据
常见问题
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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2847 次。
如何安装 Brave Images？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install brave-images」即可一键安装，无需额外配置。
Brave Images 是免费的吗？
是的，Brave Images 完全免费（开源免费），可自由下载、安装和使用。
Brave Images 支持哪些平台？
Brave Images 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Brave Images？
由 zats（@zats）开发并维护，当前版本 v1.0.1。
推荐 Skills