核心用法
该技能通过 Tavily Search API 实现网络搜索功能，专为 LLM 消费场景优化。使用时需设置 TAVILY_API_KEY 环境变量，通过 --json 参数传递 API 请求体，字段与 Tavily API 1:1 映射。
关键参数：
query: 搜索查询（建议 400 字符以内）max_results: 结果数量 0-20（默认 10）search_depth:basic（快速）或advanced（精准，推荐）time_range: 时间限定（day/week/month/year）include/exclude_domains: 域名白名单/黑名单include_raw_content: 获取完整页面内容
显著优点
1. LLM 原生优化：返回结果包含提取的文本片段、相关性评分和元数据，无需额外解析
2. 搜索深度可控：advanced 模式提供分块内容，适合复杂研究场景
3. 灵活过滤：支持时间范围、特定国家、域名限定，精准定位信源
4. 响应结构化：JSON 格式包含标题、URL、内容、评分，便于程序化处理
潜在局限
- 外部依赖：需 Tavily API 密钥，存在服务可用性和速率限制风险
- 成本考量：
advanced深度和include_raw_content可能增加 API 调用成本 - 内容覆盖：依赖 Tavily 索引范围，小众或极新内容可能缺失
- 无本地缓存：每次调用均为实时请求，高频场景需自行实现缓存层
适合人群
- 需要为 AI 应用集成实时搜索能力的开发者
- 研究人员进行快速信息核实和文献溯源
- 构建 RAG 系统需要高质量网页内容的工程师
- 需要时效性信息（新闻、股价、技术动态）的场景
常规风险
- API 密钥泄露：环境变量管理不当可能导致密钥暴露
- 数据隐私：搜索查询可能包含敏感信息，需确认 Tavily 数据处理方式
- 结果准确性：网络信息可能存在过时、偏见或错误，需人工核实关键信息
- 服务中断：第三方 API 故障将直接导致功能失效，建议实现降级策略