mcpField
B
brave-search

brave-search

github.com/alphaonedev生产力48 次安装
代码仓库

关于 brave-search

brave-search 是一项为 AI 工作流提供 Brave Search 网页搜索能力的技能，适合需要获取实时网页信息的 Agent。它支持安全搜索、语言和国家筛选，并返回包含标题、网址和描述的结果。

主要功能

  1. 01通过 Brave Search 查询网页
  2. 02设置结果数量与偏移量
  3. 03按安全级别、语言和国家筛选
  4. 04提取标题、网址与描述
  5. 05使用 API 密钥认证

适用场景

  1. 01为回答查找最新网页信息
  2. 02按地区或语言筛选搜索结果
  3. 03限制内容安全级别以筛选结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill brave-search

安装后在 Claude Code 中输入/brave-search确认已加载。

详细介绍

brave-search

用途

此技能可访问 Brave Search，这是一种注重隐私的网页搜索 API，支持在不跟踪用户的情况下搜索网页，并提供筛选和摘要提取功能，适用于 AI 驱动的应用。

适用场景

当你需要在 AI 工作流中快速、私密地搜索网页时使用此技能，例如获取实时数据以生成回复、避免收集用户查询数据，或将搜索集成到需要筛选结果的工具中（例如，为适合家庭观看的内容启用安全搜索）。

主要功能

  • 使用查询字符串、结果数量（例如，最多 50 条）以及安全搜索、语言（例如，“en-US”）和国家/地区（例如，“US”）筛选条件执行搜索。
  • 提取摘要：API 会以 JSON 格式返回每条结果的标题、URL 和描述字段。
  • 隐私功能：不跟踪用户；搜索结果基于 Brave 的索引。
  • 速率限制：根据方案，每个 API 密钥每天最多可发送 1000 次请求。

使用模式

始终使用 $BRAVE_API_KEY 环境变量对请求进行身份验证。向端点发送带有所需参数的 HTTP GET 请求。将查询构造成 URL 编码字符串。对于 AI Agent，可通过 Python 或 curl 等语言和工具中的 HTTP 客户端进行集成。通过循环测试分页：递增 'offset' 参数（例如，从 0 开始，然后设为 10）。

常用命令/API

端点：https://api.search.brave.com/res/v1/web/search
身份验证：在标头中包含 'X-Subscription-Token: $BRAVE_API_KEY'（在环境中通过 export BRAVE_API_KEY=your_key 设置）。
关键参数：q（查询字符串）、count（结果数量，例如，10）、offset（分页用，例如，0）、search_lang（例如，“en”）、country（例如，“US”）、safe（例如，设为“active”以启用安全搜索）。
curl 命令示例：

curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=AI+assistants&count=5&search_lang=en"

使用 requests 的 Python 代码片段：

import requests; import os;  
response = requests.get('https://api.search.brave.com/res/v1/web/search', headers={'X-Subscription-Token': os.environ['BRAVE_API_KEY']], params={'q': 'open source AI', 'count': 3})

配置格式：在 .env 文件中将 API 密钥存储为 BRAVE_API_KEY=your_key，并使用 python-dotenv 等库加载。

集成说明

在 AI Agent 代码中封装 API 调用即可完成集成；使用异步请求以避免阻塞。例如，在 OpenClaw 中，对于需要外部数据的回复，应在生成回复前调用此技能。通过导出 $BRAVE_API_KEY 或从安全保管库读取来处理配置。如果与其他 AI API 结合使用，可在语言模型等工具之后调用此技能，以丰富输出（例如，先搜索背景信息，再进行总结）。由于网页内容变化频繁，避免缓存结果超过 1 小时。

错误处理

检查 HTTP 状态码：200 表示成功，401 表示 API 密钥无效（验证 $BRAVE_API_KEY 后重试），429 表示超出速率限制（等待后使用指数退避策略重试，例如，等待 5-10 秒）。解析 JSON 响应，检查 "error": "Bad request" 等错误，并记录详细信息。在代码中使用 try-except 代码块：

try: response = requests.get(...)  
except requests.exceptions.RequestException as e: print(f"Error: {e}"); exit(1)

对于 CLI，可将输出传递给 grep，以查找错误模式；发生故障时，通过非零代码退出。

具体使用示例

  1. 搜索最新 AI 新闻：用于获取 AI 相关主题的头条新闻。命令：curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=latest+AI+advancements&count=3&search_lang=en"。在 Agent 中提取第一条结果的摘要，并将其附加到回复中。
  2. 提取摘要以分析查询：对于“best open source tools”这样的用户查询，运行：curl -H "X-Subscription-Token: $BRAVE_API_KEY" "https://api.search.brave.com/res/v1/web/search?q=best+open+source+tools&safe=active&country=US"。处理 JSON 以提取描述，然后在 AI 推理中使用这些信息，根据提取的数据推荐工具。

关系图

  • 相关于：ai-apis（集群），因为它为其他 AI 工具提供搜索能力。
  • 连接到：ai-apis 中的其他搜索 API（用于备用选项），或用于结果分析的数据处理技能。

评论

支持 Markdown