用途：bx-search 让 AI 智能体通过 bx 命令行工具调用 Brave Search API 完成各类网络检索，替代内置 web_search 工具。默认子命令为 context，裸执行 bx "query" 等同于 bx context "query"，一次调用即可完成搜索、抓取与内容提取，输出按 token 预算裁剪的预提取内容，适合 RAG 与 LLM 上下文注入。
主要能力：context 返回带相关性评分的网页内容；answers 提供 OpenAI 兼容的 AI 合成回答，默认流式输出；web 返回完整搜索结果，支持 site: 等搜索运算符；news 支持时效过滤；images、videos、places、suggest、spellcheck、pois、descriptions 分别覆盖图片、视频、本地地点、补全、拼写检查与 POI 详情。Goggles 支持自定义重排序，可按域名或 URL 路径 boost、downrank、discard，也可用 --include-site / --exclude-site 快捷过滤。
使用方式：macOS/Linux 安装命令为 curl -fsSL https://raw.githubusercontent.com/brave/brave-search-cli/main/scripts/install.sh | sh；Windows 为 powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/brave/brave-search-cli/main/scripts/install.ps1 | iex"。配置密钥可用 bx config set-key YOUR_API_KEY，密钥优先级为 --api-key 参数、BRAVE_SEARCH_API_KEY 环境变量、配置文件。API Key 需在 https://api-dashboard.search.brave.com 注册获取，各计划含每月 5 美元免费额度（约 1000 次查询），不同端点可能需要不同计划。
适用场景：查询文档、报错与代码模式，获取带引用的合成解释，检索特定站点、论坛讨论、最新版本与安全漏洞信息，以及本地地点搜索。
限制：需要 Brave Search API Key 与相应计划；部分端点受计划限制；存在速率限制与退出码（如 429 需重试）；Goggles 仅支持 context、web、news；--api-key 会暴露在进程列表中，建议使用环境变量或配置文件。资料未提供具体价格、平台覆盖范围与效果数据。