核心用法
Tavily Search Skill 是一款基于 Tavily API 的网络搜索工具，提供结构化、高质量搜索结果。用户需自行配置 TAVILY_API_KEY 环境变量，通过 ./search.sh 脚本执行搜索，支持自定义结果数量、图片检索、配额查询及付费模式切换。
基本命令：
./search.sh "query"— 基础搜索./search.sh "query" 5 true— 返回5条含图片的结果./search.sh --usage— 查看配额使用./search.sh --toggle-paid-mode— 切换付费优先模式
显著优点
- 智能结构化输出：返回包含标题、链接、摘要的标准化 JSON，便于后续处理
- 实时配额管理：自动追踪免费/付费配额消耗，避免超额调用
- 灵活模式切换：支持优先使用免费或付费额度，适应不同成本场景
- 完善错误处理：覆盖网络故障、配额不足等异常情况
- 轻量依赖：仅需
curl和jq，跨平台易部署
潜在局限
- 强制 API Key：用户必须自行申请 Tavily 账号并获取密钥，入门门槛存在
- 免费额度有限：每月仅 1000 次请求，重度使用需付费升级
- 单次结果上限：最多返回 20 条结果，深度研究可能需多次调用
- 无原生缓存：重复查询将消耗配额，建议上层应用自行实现缓存策略
适合人群
- AI 应用开发者（需为 Agent 添加搜索能力）
- 研究人员与信息分析师
- 需要实时网络数据的工作流自动化场景
- 对搜索结果质量有要求、愿为 API 付费的专业用户
常规风险
- API Key 泄露风险：环境变量方式存储，多用户环境需权限管控
- 配额误耗：模式切换或脚本循环调用可能导致意外超额
- 依赖外部服务：Tavily 平台可用性直接影响功能