Tavily Search Skill

核心用法

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 平台可用性直接影响功能

核心用法

Tavily Search Skill 是一个基于 Shell 脚本的 OpenClaw 技能，用于调用 Tavily AI 搜索 API 获取高质量网络搜索结果。用户需预先配置 TAVILY_API_KEY 环境变量，通过 ./search.sh 命令执行搜索，支持指定结果数量（1-20条）、是否包含图片、配额查询及付费/免费模式切换等功能。

显著优点

• 零依赖风险：仅使用系统标准工具 curl 和 jq，无第三方包依赖，供应链攻击面极小
• 安全凭证管理：API Key 通过环境变量注入，代码中无硬编码敏感信息，符合安全最佳实践
• 结构化输出：返回标准 JSON 格式结果，包含标题、链接、摘要及实时配额信息，便于下游自动化处理
• 配额精细化管理：支持免费/付费配额分离显示与模式切换，帮助用户优化 API 调用成本
• 网络传输安全：仅访问官方 api.tavily.com，全程 HTTPS/TLS 1.2+ 加密

潜在缺点与局限性

• 外部服务依赖：核心功能完全依赖 Tavily API 可用性，服务中断或接口变更将直接导致技能失效
• 环境变量配置门槛：要求终端用户手动配置环境变量，对非技术用户不够友好，且存在内存中明文存储的潜在风险
• 功能边界明确：仅为搜索封装层，不提供结果后处理、缓存或离线能力
• 个人维护项目：作者为个人开发者，长期维护承诺与商业支持有限

适合人群

• 需要将 AI 搜索能力集成到自动化工作流的技术团队
• 已持有 Tavily API Key 且熟悉命令行操作的用户
• 对供应链安全敏感、希望最小化依赖的攻击面的场景

常规风险

• API 服务可用性风险（单点故障）
• 免费额度耗尽导致服务中断
• 环境变量误配置或泄露导致的未授权调用
• 搜索结果质量依赖 Tavily 算法，无本地可控的排序干预能力