1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | web-search-brave-brave-search-skills |
| 作者/维护者 | Brave Software（GitHub 组织：brave） |
| 来源链接 | https://github.com/brave/brave-search-skills/tree/main/skills/web-search |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 164（数据来自 GitHub API，为合集仓库整体星数，不代表本技能自身热度） |
| Forks | 11（数据来自 GitHub API） |
| 最新版本 | 仓库未发布正式 Release/Tag，按提交历史滚动更新，最近一次功能性提交为 2026-04-08（数据来自 GitHub API） |
| 安装方式 | Claude Code 插件市场一条命令，或 curl 一行命令，或 git clone 手动复制 |
2. 功能介绍与亮点
调用 Brave 官方 Search API 的 /res/v1/web/search 端点，返回含标题、URL、摘要、缩略图的排序结果，支持时效过滤、SafeSearch、分页与 Goggles 自定义排序，GET/POST 均可。该技能是 Brave 官方 brave-search-skills 仓库的子技能之一，仓库内另有 llm-context、answers、images-search、news-search 等平行技能；官方文档中把它标注为 “Primary search endpoint”（基础搜索入口）。文档详尽，含技能间对比表，并分别给出 Claude Code、Codex、OpenClaw 的安装配置步骤。
3. 适用场景
固定分类：集成与工作流自动化
- 需要 Agent 在编码或调研中实时联网查资料、核实最新信息的用户
- 需要按时效、地域、SafeSearch 等条件精细化检索的用户
- 希望用官方一手数据源获取近期信息、而非仅依赖模型训练知识的用户
4. 跨 Agent 兼容性
- Claude Code：原生支持——插件市场一条命令安装，
settings.json配置示例齐全 - Codex：原生支持——README 给出
config.toml配置示例 - OpenClaw：原生支持——README 给出
.env与openclaw.json两种配置方式 - Hermes Agent：未验证——README 列出多个受支持 Agent 但未点名 Hermes，仓库 topics 也无相关标签
5. 推荐理由
Brave 把自家 Search API 封装成开箱即用的 Agent Skill，解决“Agent 无法联网获取最新信息”的痛点。相比自建 MCP Server，只需配置一个官方 API Key、一条命令即可安装；官方维护、MIT 开源可审计、文档质量高。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Brave Software 是 Brave Search API 的官方出品方；仓库整体 164 星，且属合集仓库、不代表本子技能自身独立热度 |
| 可用性 | 8 | 文档详尽、含多 Agent 分别配置示例与一条命令安装路径，近 4 个月内有实质性提交，维护活跃；需自行申请并配置 API Key |
| 安全性 | 8 | 代码执行范围明确（仅 curl 调用 Brave 官方 API），外联目标透明且就是技能本身用途；API Key 通过环境变量存储，文档专门给出“优先用 Agent 原生配置而非 shell profile 导出”的安全建议；MIT 开源可审计，官方仓库维护尚属活跃 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ①shell 命令及权限范围 | 仅执行只读的 curl 网络请求，无破坏性 shell 操作 |
| ②运行时外发数据 | 是，将搜索关键词发送至 Brave 官方 API——这正是本技能的核心用途，目标透明 |
| ③API Key/凭据存储 | 需要 BRAVE_SEARCH_API_KEY，通过各 Agent 的环境变量机制配置，文档给出安全实践建议 |
| ④可疑指令 | 未发现 prompt injection 或混淆代码迹象 |
| ⑤作者信誉 | Brave Software 官方组织，公开可查、无造假迹象 |
| ⑥License | MIT，明确 |
| ⑦最近维护 | 最近一次功能性提交 2026-04-08，约 4 个月前，仍在活跃维护窗口内 |
综合评分：7.67（三项均值）
7. 跟同类 Skills 相比的优势
| 维度 | web-search（Brave） | AnySearch Skill |
|---|---|---|
| 数据来源 | Brave 自有搜索索引，官方一手数据 | 自建搜索服务，未说明底层数据来源 |
| 是否需要 API Key | 需要 | 可匿名使用，配置后限额提升 |
| 覆盖范围 | 网页搜索为主，images/news/answers 等为并列的独立技能 | 单一技能内打包通用网页搜索 + 23 个垂直领域（金融、学术、专利、CVE 等） |
| 自定义排序 | 支持 Goggles 自定义排序规则 | 未见此类能力 |
| 批量查询 | 单次一个查询 | 支持一次调用携带多个查询 |
两者定位不同：Brave web-search 胜在官方数据源质量与细粒度排序控制，AnySearch 胜在免鉴权即可用与垂直领域覆盖广度，可按场景互补选择。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。已被 claudemarketplaces.com、claudepluginhub.com、awesomeskill.ai 等第三方技能市场收录镜像，并被 Brave 官方 API 文档站在“资源”页收录引用，但均未附具名评论。
9. 安装使用方式
- 插件市场：
/plugin marketplace add brave/brave-search-skills后/plugin install brave-search-skills@brave-search - curl 一行安装：
curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.claude/skills --strip-components=2 brave-search-skills-main/skills - 手动安装：
git clone后将skills/web-search复制到对应 Agent 的 skills 目录 - 安装后需在 api.search.brave.com 申请 API Key 并配置为
BRAVE_SEARCH_API_KEY环境变量（各 Agent 配置位置见第 4 章），新会话即生效，无需重启
10. 注意事项
- 需自行申请 Brave Search API Key，具体计费与免费额度以官方定价页为准，本报告未核实
- 本技能是合集仓库子技能，仓库内另有 llm-context、answers、images-search、news-search 等平行技能，按需单独安装
- 仓库无正式版本号标签，建议以最近提交记录判断维护状态