用途：调用 Brave Search API 进行网络搜索，适用于用户说“search web”“Brave search”或要求“find on web”且未指定 Google 的场景。
主要能力：支持网页搜索（/res/v1/web/search）、图片搜索（/images/search）、视频搜索（/videos/search）和新闻搜索（/news/search）。网页搜索可设置国家（country）、语言（search_lang）、每页数量（count，1-20，默认 10）、分页偏移（offset，0-9）、安全搜索（safesearch：off/strict）和时效过滤（freshness：pd/pw/pm/py 或自定义日期范围）。图片搜索单次最多 200 条，视频搜索最多 50 条，新闻搜索默认时效为过去一天。
使用方式：需先设置环境变量 BRAVE_API_KEY，API 基础地址为 https://api.search.brave.com/res/v1，认证使用 X-Subscription-Token 请求头。示例：curl -s "https://api.search.brave.com/res/v1/web/search?q=artificial+intelligence" -H "Accept: application/json" -H "X-Subscription-Token: $BRAVE_API_KEY"。查询含特殊字符时用 --data-urlencode。
适用场景：需要快速获取网页、图片、视频或新闻结果的自动化流程与智能体工具调用。
限制：免费层速率限制为每秒 1 次查询；分页最大 offset 为 9（count=10 时共 100 条结果）；本地商家搜索需 Pro 订阅；图片/视频搜索的 safesearch 仅支持 off 和 strict。请求失败时可运行 zero doctor check-connector --env-name BRAVE_API_KEY 或 zero doctor check-connector --url https://api.search.brave.com/res/v1/web/search --method GET 排查。Brave 不追踪用户、不存储搜索历史。