核心用法
brave-api-free-search 是一款面向 OpenClaw 生态的免费网页搜索技能，旨在为零预算用户提供商业级搜索 API 的替代方案。该技能通过本地 Docker 化部署 SearXNG 搜索引擎，将用户查询路由至本地实例，返回结构化搜索结果。
部署流程：
1. 运行 python scripts/install.py 进行标准安装（启用安全搜索与速率限制）
2. 或使用 python scripts/install.py --dev 进入开发模式（禁用安全限制）
3. 依赖 Docker 与 Python3 环境
4. 通过环境变量 SEARXNG_BASE_URL 指定本地 SearXNG 实例地址
典型使用场景：
- 需要网页搜索能力但不愿/无法支付 API 费用的开发者
- 对数据隐私敏感、要求搜索请求不出境的本地化场景
- 作为 Brave API、Google Custom Search 等付费服务的 Drop-in 替代
显著优点
1. 零成本运营：完全规避 API 调用费用，适合长期运行的自动化工作流
2. 隐私优先：本地部署确保搜索关键词不经过第三方服务器，符合数据合规要求
3. 安全机制：默认启用 safe_search 过滤与请求速率限制，降低滥用风险
4. OpenClaw 原生集成：遵循 OpenClaw 技能规范，配置即插即用
5. 开发友好：--dev 模式为调试提供便利，明确区分生产/开发环境
潜在缺点与局限性
| 维度 | 说明 |
|------|------|
| **基础设施依赖** | 要求本地具备 Docker 运行能力，对资源有限的边缘设备不友好 |
| **结果质量波动** | SearXNG 聚合多引擎结果，排名相关性与 Brave API 存在差异 |
| **维护负担** | 需自行维护 SearXNG 实例更新、IP 信誉管理 |
| **地理限制** | 本地实例的出口 IP 决定搜索结果的地域相关性 |
| **开发模式风险** | `--dev` 标志若被意外用于生产，将暴露于内容安全风险与滥用风险 |
适合人群
- 独立开发者/小型团队：预算敏感，需要基础搜索能力支撑 AI Agent 或自动化脚本
- 隐私合规场景：金融、医疗等对数据出境严格管控的行业
- 技术爱好者：希望理解搜索聚合原理，愿意承担自建基础设施成本
常规风险
1. 误用开发模式：--dev 标志的设计意图是本地调试，但文档未强制要求环境校验，存在被无意部署至生产环境的可能
2. SearXNG 实例安全：若 SEARXNG_BASE_URL 指向非受控的公共实例，搜索数据将被第三方获取，丧失本地部署的隐私优势
3. 依赖链攻击面：Docker 镜像与 Python 安装脚本来自外部源，需验证 local-search-pro 及脚本完整性
4. 无 SLA 保障：自建服务的可用性完全依赖用户运维能力，不适合关键业务路径
综合评估
该技能在"免费"与"自主可控"维度表现突出，是付费搜索 API 的经济替代方案。但用户需清醒认识其技术债务：本地基础设施的运维成本、结果质量的不可控性、以及开发模式标志带来的潜在误配置风险。建议仅在非核心场景使用，并严格隔离生产与开发部署。