SuperAPI AI 工具集

brave-search

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:该技能封装 Brave Search API,提供快速、注重隐私的网页搜索,并支持按地区与语言返回本地化结果。

主要能力:支持关键词搜索;可设置返回数量(count,1-20,默认20)与分页偏移(offset);可按两位国家代码(country,如 JP、US、GB、DE)、搜索语言(search_lang)、界面语言(ui_lang)筛选;支持安全搜索(safesearch:strict、moderate、off);支持时间筛选(freshness:pd、pw、pm、py 或 YYYY-MM-DDtoYYYY-MM-DD 日期范围);支持结果类型过滤(result_filter:web、news、images、videos);可开启查询词加粗(text_decorations)与拼写检查(spellcheck);可设置距离单位(units:km、mi)。

使用方式:API 凭据存放于 ~/.clawdbot/brave-search-config.json,格式为 {"apiKey": "your_brave_search_api_key_here"}。基础端点为 https://api.search.brave.com/res/v1/web/search,请求需带 X-Subscription-Token 头。示例:curl -X GET 'https://api.search.brave.com/res/v1/web/search?q={query}' -H 'Accept: application/json' -H 'Accept-Encoding: gzip' -H 'X-Subscription-Token: {apiKey}'。资料还提供 search.sh 与 search_ja.sh 辅助脚本,以及用 jq 解析 .web.results 的示例。

适用场景:需要本地化网页搜索、近期新闻检索、按日期范围查找资料,或在脚本与智能体中集成搜索能力。

限制:免费层为每月 2,000 次请求,实际限额以订阅为准;查询参数需 URL 编码;响应默认 gzip 编码;必须携带 API 密钥头。其余收费、平台与效果信息暂未提供。