名称： brave-images
描述： 使用 Brave Search API 搜索图片。当需要查找任何主题的图像、图片、照片或视觉内容时使用。需要设置 BRAVE_API_KEY 环境变量。

Brave 图像搜索

通过 Brave Search API 搜索图像。

使用方法

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

参数说明

响应解析

每个结果中的关键字段：
- results[].title — 图像标题
- results[].properties.url — 完整图像 URL
- results[].thumbnail.src — 缩略图 URL
- results[].source — 来源网站
- results[].properties.width/height — 图像尺寸

示例

搜索在以色列的“日落海滩”图像：

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"

从 JSON 响应中提取：
- 缩略图：.results[0].thumbnail.src
- 完整图像：.results[0].properties.url

结果呈现

呈现图像搜索结果时：
1. 直接向用户发送图像（不要仅列出 URL）
2. 使用 results[].properties.url 获取完整图像，或 results[].thumbnail.src 获取缩略图
3. 包含图像标题作为说明文字
4. 如果存在更多结果，告知用户（例如：“找到 20 张图像，显示 3 张 — 需要查看更多吗？”）

示例流程：

用户：“帮我找日落的图片”
→ 使用 count=10 进行搜索
→ 发送 3-5 张带标题的图像
→ “找到 10 张日落图像，显示 5 张。需要查看更多吗？”

注意事项

• 查询字符串需进行 URL 编码（空格 → %20）
• API 密钥来自环境变量：$BRAVE_API_KEY
• 请根据订阅级别遵守速率限制