核心用法
Tavily Web Search 是一个基于官方 API 的 Python 搜索工具，通过命令行脚本提供企业级搜索能力。核心调用方式为：
python3 {baseDir}/scripts/search.py --query "搜索内容" [选项]支持四大搜索深度模式（ultra-fast/fast/basic/advanced）、主题分类（general/news/finance）、时间范围过滤、域名白名单/黑名单、国家定向等 15+ 项官方参数。输出格式可选 compact Markdown、详细 Markdown、Brave 兼容 JSON 或原始 JSON。
显著优点
1. 官方 API 完整覆盖：非第三方爬虫，直接调用 Tavily 官方服务，数据合法性与稳定性有保障
2. AI 原生设计：内置 include-answer 生成 AI 摘要，auto-parameters 让 API 智能选择最佳配置，天然适配 RAG 和 Agent 场景
3. 成本优化机制：1 小时 TTL 查询缓存、指数退避重试、信用消耗透明化（basic=1 credit, advanced=2 credits），免费额度 1000 credit/月
4. 生产级特性：自动更新脚本保持 API 兼容性、详细日志记录、多输出格式兼容现有工具链
5. 精准控制：支持精确短语匹配 (--exact-match)、完整页面内容提取 (--include-raw-content)、图片搜索等深度需求
潜在局限
- 网络依赖：服务托管于海外，国内访问需稳定网络环境
- 免费额度限制：1000 credit/月 约等于 500-1000 次基础搜索，高频使用需付费升级
- 英文内容优势：虽支持多语言，但算法优化偏向英文信息源
- 缓存一致性：1 小时 TTL 在快速变化的新闻场景下可能返回过时结果
适合人群
- 构建 RAG 系统的开发者，需要结构化、带评分的搜索数据
- AI Agent 开发者，需要自动化的网络信息检索与摘要能力
- 研究人员，需要按时间、域名、国家精准过滤的学术/新闻搜索
- 内容创作者，需要快速获取多来源信息并生成引用格式的参考
常规风险
- API Key 泄露：需妥善保管
TAVILY_API_KEY，避免硬编码提交至版本控制 - 成本超支：advanced 模式 + include_answer + raw_content 单次可达 4 credits，批量脚本需设置预算监控
- 内容合规：Tavily 返回内容为第三方网页信息，需自行审核版权与合规性
- 服务依赖：单点依赖 Tavily 服务可用性，建议实现降级方案