Tavily Search Skill

核心用法

Tavily Search Skill 是一个基于 Shell 脚本的 OpenClaw 技能，用于调用 Tavily AI 搜索引擎 API。用户需自行配置 TAVILY_API_KEY 环境变量，通过 ./search.sh 执行搜索，支持自定义结果数量、图片返回、额度查询及付费模式切换。

主要命令：

• 基础搜索：./search.sh "关键词"
• 指定数量：./search.sh "关键词" 10
• 包含图片：./search.sh "关键词" 5 true
• 额度管理：--usage、--toggle-paid-mode、--status

显著优点

1. 结构化输出：返回标准 JSON，包含标题、链接、摘要及配额信息，便于程序解析
2. 额度透明化：实时显示免费/付费额度使用情况，避免超额风险
3. 灵活付费控制：支持手动切换付费模式，适应不同成本场景
4. 零依赖封装：仅需系统自带的 curl 和 jq，无需额外运行时

潜在局限

• 硬性依赖外部 API：服务可用性完全依赖 Tavily 平台稳定性
• 无本地缓存机制：重复搜索会消耗配额，无智能去重或缓存层
• Shell 环境限制：Windows 用户需额外配置 WSL 或 Git Bash
• 功能边界清晰：仅支持搜索，无网页内容抓取、深度分析等扩展能力

适合人群

• 需要为 AI Agent 集成实时网络搜索能力的开发者
• 对 API 成本敏感、需要精细化额度控制的小团队
• 偏好轻量级 Shell 工具而非 Python/Node 重依赖的技术用户

常规风险

• 密钥泄露风险：API Key 以环境变量形式存储，多用户服务器可能存在暴露隐患
• 额度突耗尽：免费版月限 1000 次，高频自动化任务易触发上限
• 网络单点故障：无重试机制，Tavily 服务中断时搜索功能完全失效
• 数据隐私：搜索查询需发送至第三方服务器，敏感信息存在外泄可能

核心用法

Tavily Search Skill 是一个基于 Bash 的网络搜索工具，通过调用 Tavily API 返回结构化搜索结果。使用前必须配置环境变量 TAVILY_API_KEY，支持基础搜索、指定结果数量（1-20 条）、图片检索、额度查询及付费模式切换等功能。输出为 JSON 格式，包含搜索摘要、来源链接及实时额度信息。

显著优点

• 功能专注实用：搜索响应结构化，便于下游自动化处理；额度管理透明，免费/付费额度分离显示
• 安全设计良好：无敏感信息硬编码，API Key 由用户自主配置；依赖极简（仅 curl + jq），供应链攻击面小
• 传输加密合规：HTTPS 加密传输，符合 GDPR 数据最小化原则，隐私合规检查通过
• 行为透明可审计：代码量小（529 行），功能与声明完全一致，静态分析未发现危险函数

潜在缺点与局限性

• 来源可信度限制：T3 等级（个人开发者），未经知名组织背书，需用户自行审查代码
• 外部依赖单一：完全依赖 Tavily 服务可用性，若 API 变更或限流将直接影响功能
• 免费额度有限：每月 1000 次请求，高频场景需付费升级
• 无高级过滤：不支持搜索结果排序、时间筛选、站点限定等高级搜索语法

适合人群

• 需要快速集成搜索功能的开发者、自动化脚本编写者
• 对数据隐私敏感、愿意自行管理 API Key 的技术用户
• 低频次搜索场景（调研、信息补全、RAG 知识库构建）

常规风险

• 数据外发：搜索查询词将传输至 Tavily 美国服务器，敏感信息不宜直接搜索
• T3 来源风险：建议隔离环境先行测试，关注社区反馈与更新
• 额度耗尽风险：无自动预警机制，需定期 --usage 检查