核心用法
nano-web-search 是通过 NanoGPT API 聚合多搜索服务商的统一接口工具，支持 Linkup、Tavily、Exa、Kagi、Perplexity、Valyu、Brave 共 7 家提供商。用户可通过 CLI 或 Python API 发起搜索，支持基础检索、深度搜索（deep）、带引用合成答案（sourcedAnswer）及结构化输出三种模式，并可按时间范围、域名黑白名单过滤结果。
显著优点
- 多源聚合：单 API 密钥即可切换 7 家搜索服务商，便于对比质量与成本
- 灵活计费：按次付费，价格区间 $0.0015–$0.06，无订阅门槛
- 输出多样：原始结果列表、带引用摘要、结构化 JSON 三种格式适配不同场景
- Python 友好：提供原生 Python 类
NanoWebSearch，支持显式传参或环境变量读取 - 过滤精细：支持日期范围、域名包含/排除、结果数量限制
潜在局限
- 外部依赖重：需独立申请 NanoGPT API 密钥，且底层服务商稳定性受第三方影响
- 文档简略：未详述速率限制、错误重试策略、超时机制
- 成本不透明：Valyu 按结果计费，实际费用随返回条数浮动，难以预估
- 隐私风险：搜索查询需经 NanoGPT 中转，敏感信息可能暴露给聚合方
适合人群
- 需要快速对比多搜索源质量的开发者与研究员
- 构建 RAG/AI Agent 需程序化搜索接口的团队
- 低频搜索、不愿承担月费订阅的轻量用户
常规风险
- 密钥泄露：
NANOGPT_API_KEY需妥善保管，避免硬编码提交至代码仓库 - 供应商锁定：若 NanoGPT 服务中断，需迁移至各搜索商原生 API
- 内容合规：聚合搜索结果未经过滤，可能返回版权或敏感内容，需自行校验