核心用法
Tavily Search Skill 是一个轻量级 Shell 脚本封装，用于快速调用 Tavily AI 搜索 API。基础用法为 ./skills/tavily/search.sh "关键词"，支持三个参数：搜索词、结果数量（默认5条，最大20条）、是否包含图片。配置采用本地明文存储的 API Key 模式，开箱即用。
显著优点
1. 实时搜索能力：直接对接 Tavily 搜索引擎，可获取最新网络信息，弥补大模型知识截止日期限制
2. 额度透明管理：内置每月 1000 次请求的限额提示，便于成本控制
3. 结果质量较高：Tavily 专为 AI 场景优化，返回结构化、高信噪比的搜索结果
4. 轻量无依赖：纯 Shell 脚本实现，无需额外运行时环境
潜在缺点与局限性
- 密钥安全风险：API Key 以明文硬编码于脚本中（
tvly-dev-...），存在泄露隐患，不适合团队协作或多租户场景 - 额度刚性限制：1000 次/月的免费额度对高频场景可能不足，且脚本未实现用量预警机制
- 功能单一：仅支持基础文本搜索，缺乏 Tavily API 的高级功能（如深度检索、自定义领域、答案生成等）
- 错误处理简单：依赖外部提示用户更换密钥，无自动重试或降级逻辑
适合人群
- 个人开发者进行快速原型验证
- 需要临时补充实时信息的 AI 对话工作流
- 低频率、非敏感场景的自动化搜索任务
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | 明文存储的 dev 密钥一旦上传代码仓库即暴露 |
| 额度耗尽 | 无预警机制可能导致服务突然中断 |
| 依赖单点 | Tavily 服务可用性直接影响功能 |
| 合规风险 | 搜索内容可能涉及版权或地域法律限制 |