Brave Images

Brave Image Search 是一个基于 Brave Search API 的图片搜索技能，允许用户通过简单的 API 调用获取任何主题的图片、照片和视觉内容。该技能采用纯 Markdown 文档形式实现，无本地可执行代码，所有功能完全依赖外部 Brave Search API。

核心用法：用户通过发送 GET 请求到 api.search.brave.com/res/v1/images/search，携带搜索关键词 q、结果数量 count（1-100）、地区代码 country、语言 search_lang 和安全搜索级别 safesearch 等参数。响应包含图片标题、完整 URL、缩略图、来源网站及尺寸信息。技能要求预先设置 BRAVE_API_KEY 环境变量作为身份认证凭证。

显著优点：
1. 架构简洁：纯文档型技能，无复杂依赖，易于理解和维护
2. API 可信度高：调用 Brave Software 官方搜索服务，TLS 加密传输，数据安全保障完善
3. 功能丰富：支持多语言、多地区筛选，安全搜索分级（off/moderate/strict），结果包含完整元数据
4. 使用成本低：按调用次数计费，无额外基础设施要求
5. 隐私友好：Brave 以隐私保护著称，不跟踪用户搜索历史

潜在缺点与局限性：
1. 功能单一：仅限图片搜索，无法处理图片分析、编辑或生成
2. 外部依赖强：完全依赖 Brave API 可用性，网络中断或服务变更将直接影响功能
3. 成本门槛：需订阅 Brave Search API 并获取有效密钥，存在持续费用
4. 结果不可控：图片质量和版权状态取决于网页源，存在法律风险
5. 无本地缓存：每次搜索均需实时调用 API，无法离线使用

适合人群：

• 需要快速集成图片搜索功能的开发者
• 内容创作、媒体监测、电子商务等场景的用户
• 重视隐私保护、不愿使用 Google/Bing 搜索 API 的组织
• 具备基础 API 调用能力和环境变量配置经验的用户

常规风险：
1. API 密钥泄露风险：BRAVE_API_KEY 若管理不当可能被滥用，建议通过安全密钥管理服务存储并定期轮换
2. 版权合规风险：搜索结果图片的版权归属各异，商用前需确认授权许可
3. 内容过滤依赖：moderate/strict 级别的安全搜索可能误过滤合法内容，或未能完全屏蔽不当图片
4. 速率限制：超出订阅层级限额将导致服务中断，需合理规划调用频率

核心用法

brave-images 是一个纯 Markdown 格式的文档型 Skill，用于指导用户调用 Brave Search API 进行图片搜索。它不提供可执行代码，而是通过完整的 API 文档、参数说明和示例代码，帮助用户构建 HTTP 请求获取图片结果。

关键调用参数：

• q: 搜索关键词（必需，需 URL 编码）
• count: 返回数量 1-100（默认 20）
• country: 地区偏好（如 US, IL）
• safesearch: 安全过滤级别（off/moderate/strict）

结果解析字段：

• results[].properties.url - 原图地址
• results[].thumbnail.src - 缩略图地址
• results[].source - 来源网站
• results[].title - 图片标题

显著优点

1. 数据源可信：基于 Brave Search 官方 API，HTTPS 加密传输，无需担心中间人攻击
2. 零依赖零代码：纯文档型 Skill，无第三方依赖包，无动态代码执行风险
3. 安全凭证管理：示例代码强制使用环境变量 $BRAVE_API_KEY，拒绝硬编码密钥
4. 功能完整：支持多语言、地区偏好、安全过滤等高级搜索参数
5. CLS S 级认证：安全评分 95 分，通过全部 6 项雷达扫描

潜在局限

1. 需自行获取 API Key：用户需注册 Brave Search API 并配置环境变量，有一定使用门槛
2. 无内置结果处理：仅提供原始 API 响应结构，图片展示需用户或调用方自行实现
3. 受限于 Brave 索引：搜索结果质量取决于 Brave Search 的图片索引覆盖度
4. 速率限制：免费/付费 tier 均有 API 调用频次限制
5. 版权合规责任：图片使用需用户自行确认版权许可

适合人群

• 需要为 AI Agent 或应用集成图片搜索能力的开发者
• 注重隐私、倾向使用 Brave 生态的技术用户
• 希望避免复杂依赖、偏好轻量 HTTP API 调用的场景
• 已通过 CLS S 认证，适合对安全性有较高要求的企业环境

常规风险

• API Key 泄露风险：虽然 Skill 本身安全，但用户若错误配置环境变量或日志泄露密钥仍可能导致未授权调用
• 搜索结果不可控：Brave Search 返回的图片内容和来源不受本 Skill 控制，可能存在不当内容（建议启用 safesearch=strict）
• 服务可用性依赖：完全依赖 Brave Search API 的在线状态和服务持续性
• 地域访问限制：部分国家/地区可能无法访问 Brave Search API