用途：调用 Brave 隐私搜索 API 检索网页、图片和新闻，并可通过 AI Grounding 获取带引用的答案，适用于查询最新信息、找图、看近期新闻、获取带出处回答和自动补全建议。
主要能力：网页搜索 /res/v1/web/search、图片搜索 /res/v1/images/search、新闻搜索 /res/v1/news/search、建议 /res/v1/suggest/search 属免费；AI Grounding /res/v1/chat/completions 需订阅；本地 POI /res/v1/local/pois 与摘要 /res/v1/summarizer/search 属 Pro。
使用方式：先获取 API Key（https://api-dashboard.search.brave.com），执行 export BRAVE_API_KEY="your-api-key"。常用命令：brave-search web "query"、brave-search images "query"、brave-search news "query"、brave-search ai "question"、brave-search suggest "partial query"、brave-search check-key。常用参数：--count、--country、--lang、--safesearch、--freshness（pd/pw/pm/py）、--json、--extra-snippets、--filter、--research。
适用场景：需要当前信息、图片、近期新闻、带引用答案或位置搜索时。API 支持高并发（最高 50 请求/秒），可并行发起多个查询，结果量大时可用子代理汇总以节省上下文。
限制：需 API Key；免费层 1 请求/秒、每月 2000 次查询，Pro 限额更高；网页结果最多 20 条，图片最多 200 条；AI Grounding 需相应订阅；错误包括 401（密钥无效）、429（限流）、422（参数无效）。