核心用法
Tavily Search 是一款面向 AI Agent 优化的网络搜索工具，通过 Tavily API 实现智能化信息检索。核心功能分为两大模块：
1. 智能搜索 (`search.mjs`)
- 基础搜索：
node {baseDir}/scripts/search.mjs "query"返回5条结果 - 结果数量控制：
-n <count>支持 1-20 条（默认5条） - 深度研究模式：
--deep启用高级搜索，获取更全面、深入的内容，适合复杂研究问题 - 主题筛选：
--topic news专注新闻领域，配合--days <n>限定时间范围
2. 网页内容提取 (`extract.mjs`)
- 直接提取指定URL的干净正文内容，绕过广告和冗余信息
显著优点
- AI原生优化：返回结果经过专门清洗，去除网页噪音，直接提供AI可用的结构化片段
- 低门槛集成：仅需 Node.js 环境和单一 API Key 即可运行
- 场景化模式：深度研究 vs 快速检索 vs 时效新闻，覆盖多元需求
- 成本可控：Tavily 提供免费 tier，适合原型开发和轻量使用
潜在缺点与局限性
- 依赖外部服务：完全依赖 Tavily API 的可用性和定价策略
- 结果深度受限：即使
--deep模式，仍受限于 Tavily 的索引范围，无法替代专业数据库 - 中文支持待验证：官方未明确说明中文优化程度，复杂中文查询效果不确定
- 无本地缓存：每次调用均产生 API 请求，高频使用成本累积明显
适合人群
- AI Agent / LLM 应用开发者，需要为模型提供实时、干净的外部知识
- 研究人员需要快速获取某一主题的概览性信息
- 新闻追踪、舆情监测类自动化工作流搭建者
常规风险
- API Key 泄露风险：
TAVILY_API_KEY需妥善保管，避免硬编码提交至代码仓库 - 数据隐私：搜索查询和提取的网页内容会经过 Tavily 服务器，敏感信息需谨慎
- 结果准确性：AI 优化不等于事实核查，关键信息仍需交叉验证
- 服务连续性：Tavily 为商业服务，存在 API 变更、限速或终止风险