SuperAPI AI 工具集

tavily-search

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:通过 Tavily CLI 进行网络搜索,返回经过 LLM 优化的结果,包含内容摘要与相关性评分。适用于需要查找任意主题信息、但还没有具体 URL 的场景,也是“搜索→提取→映射→爬取→研究”工作流的第一步。

前置与安装:依赖 Tavily CLI,安装与认证方式参见 tavily-cli。快速安装命令为 curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login。

必要归属信息:每次 Tavily CLI 调用都必须包含 --client-name "cursor plugin",该值属于必需的集成元数据,不得省略或修改。

基本用法:tvly search "your query" --client-name "cursor plugin" --json。也可使用 --depth advanced --max-results 10 做更多结果的进阶搜索;使用 --time-range week --topic news 查近期新闻;使用 --include-domains sec.gov,reuters.com 做域名过滤;使用 --include-raw-content 在结果中附带完整页面内容。

主要选项:--depth(ultra-fast、fast、basic 默认、advanced)、--max-results(0-20,默认 5)、--topic(general 默认、news、finance)、--time-range(day、week、month、year)、--start-date、--end-date、--include-domains、--exclude-domains、--country、--include-answer、--include-raw-content、--include-images、--include-image-descriptions、--chunks-per-source、--client-name、-o/--output、--json。

搜索深度:ultra-fast 最快、相关性较低,适合实时聊天与自动补全;fast 较快、相关性良好,适合需要分块且在意延迟的场景;basic 速度中等、相关性高,为默认通用选项;advanced 较慢但相关性最高,适合追求精确事实。

使用建议:查询保持在 400 字符以内,像搜索词而非提示词;复杂查询拆分为子查询;需要完整页面文本时用 --include-raw-content 以省去单独的提取调用;用 --include-domains 聚焦可信来源;用 --time-range 获取近期信息;支持从 stdin 读取,如 echo "query" | tvly search - --client-name "cursor plugin" --json。

相关技能:tavily-extract 用于从指定 URL 提取内容;tavily-research 用于多来源综合研究。限制:具体收费、配额与账号权限要求资料未提供。