Tavily 是一个面向大语言模型和 AI 应用优化的搜索引擎技能,基于 Tavily Search API 封装,用于在智能体工作流中完成网络检索。
用途 该技能适合需要网络调研的任务,包括综合研究与事实查证、时事与近期动态查询、限定域名的专业检索,以及为后续分析提取页面原始内容。
主要能力
- AI 答案摘要:根据搜索结果生成简洁回答,可用 --no-answer 关闭。
- 结构化结果:每条结果包含标题、URL、内容片段与 0-1 的相关性评分;启用 --raw-content 时附带完整 HTML。
- 搜索深度:basic 模式约 1-2 秒,覆盖一般;advanced 模式约 5-10 秒,覆盖更全面,适合复杂主题研究。
- 主题范围:general 覆盖全时段广泛网页,适合教程与文档等常青内容;news 聚焦近 7 天新闻来源,适合时事。
- 域名过滤:通过 --include-domains 仅检索指定站点,通过 --exclude-domains 排除低质或无关来源。
- 图片搜索:使用 --images 返回相关图片链接。
- 结果数量控制:通过 --max-results 指定返回条数。
使用方式 脚本调用示例:scripts/tavily_search.py "What is quantum computing?";高级检索加 --depth advanced;新闻检索加 --topic news;域名限定加 --include-domains python.org docs.python.org;排除来源加 --exclude-domains;图片加 --images;原始内容加 --raw-content;需要机器可读输出时可加 --json 并重定向保存。 API Key 可通过 Clawdbot 配置的 skills.entries.tavily.apiKey 字段提供,或设置环境变量 TAVILY_API_KEY;密钥可在 https://tavily.com 注册后于控制台生成,以 tvly- 开头。依赖 Python 3.6+ 与 tavily-python 包,安装命令为 pip install tavily-python。也可在 Python 中调用 search() 函数,传入 query、api_key、search_depth、max_results 等参数,并在返回的 success 字段为真时读取 answer 与 results。
适用场景 包括:综合研究与答案获取;限定权威站点(如学术或官方文档站点)的定向检索;新闻与时事跟踪;带图片的视觉调研;为深度分析提取原始 HTML 内容。
限制与注意事项 资料未提供具体定价、免费额度与速率上限数值,仅提到使用会消耗 credits,需在 Tavily 官网查看所购方案的额度与速率限制。basic 模式比 advanced 更快,但覆盖较少;news 主题限于近 7 天新闻来源;搜索索引规模小于 Google Custom Search(资料中的对比表述)。建议默认使用 basic、按需限制 max_results、非必要不开启原始内容,并对重复查询做本地缓存以节省额度。常见问题包括脚本需可执行权限(chmod +x)、缺少 tavily-python 包、API Key 缺失或格式不符,以及触发速率限制时减少结果数或降低搜索深度。