用途
本技能用于通过 Brave Search API 进行网络搜索，返回网页结果及其描述，可选附带额外内容摘要，并支持按国家、语言、时效性和安全搜索级别进行过滤。适用于需要查找训练数据之外的实时信息、近期事件或本地化搜索结果的场景。
主要能力
- 返回网页结果，包含标题、URL、描述、时效、语言和是否适合家庭浏览等字段。
- 支持时效过滤：pd（过去一天）、pw（过去一周）、pm（过去一个月）、py（过去一年）。
- 支持按国家代码（如 US、GB、DE）和语言代码（如 en、fr、de）进行本地化搜索。
- 支持安全搜索级别：off、moderate（默认）、strict。
- 支持额外内容摘要（--extra-snippets），但需要付费 API 套餐。
- 支持 JSON 输出（--json），便于程序化使用。
- 单次请求最多返回 20 条结果，支持分页偏移（--offset）。
使用方式
前置条件：
- 设置 BRAVE_API_KEY 环境变量，API 密钥可在 https://brave.com/search/api/ 获取。
- 安装 Deno。
- 具备互联网访问。
快速开始：
deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts "your search query"
带时效过滤的示例：
deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts "React 19 new features" --freshness pw
脚本用法：
deno run --allow-env --allow-net=api.search.brave.com scripts/search.ts [options] "query"
选项：
- --results <n>：返回结果数量（最大 20），默认 5。
- --freshness <range>：时间过滤，pd、pw、pm 或 py，默认无。
- --country <code>：国家代码，用于本地化结果，默认无。
- --lang <code>：搜索语言，默认无。
- --safesearch <level>：安全搜索，off、moderate 或 strict，默认 moderate。
- --extra-snippets：包含额外内容摘要，默认 false。
- --offset <n>：分页偏移，默认 0。
- --json：以 JSON 输出，默认 false。
- --help：显示帮助信息。
适用场景
- 需要查找训练数据之外的当前信息。
- 用户询问近期事件、新闻或更新。
- 需要针对特定国家或语言的本地化搜索结果。
- 希望使用注重隐私的搜索替代方案。
- 研究需要实时网络数据。
不适用场景：
- 信息已在知识库中且无需验证。
- 用户询问不会变化的历史事实。
- 处理本地文件或代码（应使用其他工具）。
- 存在更具体的技能（如文档查找）。
- 需要 AI 生成的答案摘要（应改用 web-search-tavily）。
限制
- 需要有效的互联网连接。
- 受 Brave Search API 套餐的速率限制。
- 结果取决于 Brave 的索引覆盖范围。
- 无法访问付费墙或需要登录的内容。
- 不提供内置的 AI 生成答案摘要。
- 单次请求最多 20 条结果。
- 额外摘要需要付费 API 套餐。
常见问题
- 未设置 BRAVE_API_KEY：从 https://brave.com/search/api/ 获取密钥并设置环境变量，或内联运行。
- 无效的 API 密钥：检查密钥是否正确、是否过期、订阅是否有效。
- 速率限制超出：等待后重试、降低请求频率或升级套餐。
- 无结果返回：尝试更宽泛的搜索词，移除过于严格的国家、语言或时效过滤。