核心用法
Tavily skill 提供命令行接口，通过调用 Tavily 搜索 API 实现实时网络信息检索。主要功能包括：主题搜索获取 URL 列表、来源筛选（包含/排除指定域名）、生成带引用的内容摘要。使用方式是通过 Node.js 脚本调用，需配置 TAVILY_API_KEY 环境变量，支持 --urls-only 快速提取链接、--include_domains/--exclude_domains 精准控制搜索范围。
显著优点
1. 实时性与权威性：直接对接 Tavily 专业搜索 API，优于通用搜索引擎的时效性，适合追踪技术文档、开源仓库、标准规范等权威来源
2. 结构化输出：返回 JSON 格式结果，便于程序化处理；同时提供人类可读的 URL 列表输出
3. 精准过滤：域名白名单/黑名单机制有效过滤低质量内容（如排除 medium.com 营销文章，锁定 ietf.org 标准文档）
4. 研究效率：内置脚本简化 API 调用流程，适合批量线索挖掘、竞品调研、文献综述场景
潜在缺点与局限性
- 功能裁剪：捆绑 CLI 仅支持 Tavily 完整 API 的子集（query/max_results/domain 过滤），高级参数需直接查阅
references/tavily-api.md - 依赖外部服务：API 可用性、配额限制、定价策略完全受 Tavily 平台约束
- 无本地缓存：每次搜索均发起网络请求，高频调用成本较高
- 认证单一：仅支持 Bearer Token 认证，无多密钥轮换机制
适合人群
技术开发人员、研究人员、内容创作者——需要快速构建引用来源列表、追踪技术生态动态、对比产品文档的理性决策者。
常规风险
- API 密钥泄露：
TAVILY_API_KEY以环境变量或命令行参数传递，存在 Shell 历史记录、进程列表泄露风险 - 输出注入：搜索返回的第三方 URL 和内容未经验证，下游程序直接解析 JSON 可能遭遇恶意构造数据
- 合规边界：自动化抓取需遵守目标网站的 robots.txt 及使用条款，Tavily 作为代理层不豁免终端用户的合规责任