核心用法
Tavily Search Skill 是一个专为LLM场景设计的网页搜索工具，通过调用Tavily的API获取经过语义优化的搜索结果。核心交互模式为向https://api.tavily.com/search发送POST请求，需配置TAVILY_API_KEY环境变量。
主要功能特性
| 维度 | 能力说明 |
|------|---------|
| **搜索深度** | 四级模式（ultra-fast/fast/basic/advanced），平衡延迟与内容质量 |
| **领域过滤** | 支持include_domains/exclude_domains白黑名单机制 |
| **时间筛选** | day/week/month/year时间范围限定 |
| **主题分类** | general/news/finance三类垂直场景 |
| **内容形态** | 支持原始网页内容(include_raw_content)、AI生成摘要(include_answer)、图片结果 |
典型调用模式
# 基础搜索
./scripts/search.sh '{"query":"Python并发模式","max_results":5}'
# 学术源限定+深度搜索
./scripts/search.sh '{"query":"LLM幻觉问题","include_domains":["arxiv.org"],"search_depth":"advanced"}'
# 实时新闻
./scripts/search.sh '{"topic":"news","time_range":"day","max_results":10}'显著优点
1. LLM原生设计：返回结果包含结构化元数据（score相关性评分、content摘要），无需额外清洗即可注入提示词
2. 成本效率分层：ultra-fast模式适用于实时对话，advanced模式满足深度研究，单API覆盖多场景
3. 可信源管控：域名白名单机制可有效锁定学术(arXiv)、技术文档(GitHub)、权威媒体等高质量来源
4. 开箱即用：提供shell脚本封装，降低非开发者使用门槛
潜在局限
- 商业依赖：核心能力绑定Tavily商业API，存在服务稳定性与定价策略变更风险
- 覆盖盲区：受限于Tavily索引范围，长尾内容、私密站点、区域限定内容可能缺失
- 速率约束：max_results上限20，单次查询结果量有限，大规模数据收集需分页策略
- 中文支持未明：文档示例均为英文查询，中文分词与结果质量需实际验证
适合人群
- AI应用开发者：构建RAG系统、实时问答Agent、研究辅助工具
- 知识工作者：需要快速获取领域最新动态，替代传统搜索引擎的信息筛选流程
- 技术内容创作者：验证技术概念、引用权威来源、追踪开源项目更新
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API密钥泄露 | 本地明文存储于settings.json | 使用密钥管理服务，避免代码仓库提交 |
| 结果偏差 | Tavily的排序算法可能引入隐性偏见 | 交叉验证多个来源，不依赖单一API做事实判定 |
| 成本失控 | advanced模式+高并发场景费用累积 | 设置预算告警，生产环境启用缓存层 |
| 时效性误差 | 网页抓取存在延迟，time_range非实时 | 关键时效信息需二次源头确认 |