SuperAPI AI 工具集

tavily

通用与其它

查看项目

更新于 10-16 06:57

技能介绍

Tavily 是一个专为大语言模型和 AI 应用优化的搜索引擎。与传统的搜索 API 不同,Tavily 提供面向 AI 的结果,包括可选的答案生成、干净的内容提取和域名过滤能力。

主要能力

  • 从搜索结果生成 AI 答案摘要
  • 为 LLM 处理优化的干净、结构化结果
  • 快速(basic)和全面(advanced)两种搜索模式
  • 域名过滤(包含/排除特定来源)
  • 面向时事的新闻聚焦搜索
  • 图片搜索,返回相关视觉内容
  • 原始内容提取,用于更深入分析

搜索模式

基础与高级对比

模式 速度 覆盖范围 适用场景
basic 1-2 秒 良好 快速事实、简单查询
advanced 5-10 秒 优秀 研究、复杂主题、全面分析

选择建议:

  • 需要快速事实或定义 → 使用 basic
  • 研究复杂主题 → 使用 advanced
  • 需要多个视角 → 使用 advanced
  • 对时间敏感的查询 → 使用 basic

general 与 news 对比

主题 时间范围 来源 适用场景
general 全部时间 广泛网页 常青内容、教程、文档
news 最近 7 天 新闻网站 时事、近期动态、突发新闻

选择建议:

  • 查询包含“最新”“近期”“当前”“今天”?→ 使用 news
  • 查找历史或常青内容 → 使用 general
  • 需要最新信息 → 使用 news

使用方式

快速开始

基本搜索:

scripts/tavily_search.py "What is quantum computing?"
scripts/tavily_search.py "Python best practices" --max-results 10

高级搜索:

scripts/tavily_search.py "Climate change solutions" --depth advanced
scripts/tavily_search.py "AI developments 2026" --topic news

域名过滤:

scripts/tavily_search.py "Python tutorials" \
  --include-domains python.org docs.python.org realpython.com
scripts/tavily_search.py "How to code" \
  --exclude-domains w3schools.com geeksforgeeks.org

包含图片:

scripts/tavily_search.py "Eiffel Tower architecture" --images

API 密钥设置

方式一:ThinkFleetBot 配置(推荐)

{
  "skills": {
    "entries": {
      "tavily": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}

方式二:环境变量

export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"

可添加到 ~/.thinkfleetbot/.env 或 shell 配置文件中。

获取 API 密钥

  1. 访问 https://tavily.com
  2. 注册账号
  3. 进入仪表板
  4. 生成 API 密钥(以 tvly- 开头)
  5. 注意所在计划的速率限制和额度分配

常见使用场景

研究与事实查证

scripts/tavily_search.py "Explain quantum entanglement" --depth advanced
scripts/tavily_search.py "Best practices for REST API design" \
  --max-results 10 \
  --include-domains github.com microsoft.com google.com

时事查询

scripts/tavily_search.py "AI policy updates" --topic news
scripts/tavily_search.py "quantum computing breakthroughs" \
  --topic news \
  --depth advanced

特定领域研究

scripts/tavily_search.py "machine learning algorithms" \
  --include-domains arxiv.org scholar.google.com ieee.org
scripts/tavily_search.py "React hooks guide" \
  --include-domains react.dev

视觉研究

scripts/tavily_search.py "modern web design trends" \
  --images \
  --max-results 10

内容提取

scripts/tavily_search.py "Python async/await" \
  --raw-content \
  --max-results 5

响应处理

AI 答案

AI 生成的答案会从搜索结果中综合出简洁摘要,例如:

{
  "answer": "Quantum computing is a type of computing that uses quantum-mechanical phenomena..."
}

使用时机:需要快速摘要、希望从多个来源综合信息、寻找问题的直接答案。 跳过时机(--no-answer):只需来源 URL、希望自行综合、节省 API 额度。

结构化结果

每条结果包含:

  • title:页面标题
  • url:来源 URL
  • content:提取的文本片段
  • score:相关性评分(0-1)
  • raw_content:完整 HTML(启用 --raw-content 时)

图片

启用 --images 时,返回搜索中找到的相关图片 URL。

最佳实践

  1. 选择合适的搜索深度:多数查询先用 basic(更快、更省);仅当初始结果不足、主题复杂或需要全面覆盖时升级到 advanced。
  2. 策略性地使用域名过滤:包含域名用于学术研究(.edu 域名)、官方文档、可信新闻源和已知权威来源;排除域名用于已知低质量内容农场、无关内容类型以及有付费墙或访问限制的网站。
  3. 优化成本:默认使用 basic 深度,限制 max_results 为实际需要的数量,除非必要不启用 include_raw_content,对重复查询进行本地缓存。
  4. 优雅处理错误:脚本提供有用的错误信息,如缺少 API 密钥或未安装包时的提示。

集成模式

编程方式使用:

from tavily_search import search

result = search(
    query="What is machine learning?",
    api_key="tvly-...",
    search_depth="advanced",
    max_results=10
)

if result.get("success"):
    print(result["answer"])
    for item in result["results"]:
        print(f"{item['title']}: {item['url']}")

JSON 输出用于解析:

scripts/tavily_search.py "Python tutorials" --json > results.json

与其他工具链式使用:

scripts/tavily_search.py "React documentation" --json | \
  jq -r '.results[].url' | \
  xargs -I {} curl -s {}

与其他搜索 API 的对比

与 Brave Search 相比:具备 AI 答案生成、原始内容提取、更好的域名过滤;速度较慢、消耗额度。

与 Perplexity 相比:对来源有更多控制、可获取原始内容、有专门的新闻模式;答案质量和速度相近。

与 Google Custom Search 相比:结果针对 LLM 优化、有答案生成、API 更简单;索引较小;成本结构相近。

故障排查

脚本无法运行:

chmod +x scripts/tavily_search.py
python3 --version
pip install tavily-python

API 密钥问题:

echo $TAVILY_API_KEY
scripts/tavily_search.py "test" --api-key "tvly-..."

速率限制错误:查看 https://tavily.com 上的额度分配,减少 max_results,使用 basic 深度,对重复查询实施本地缓存。

依赖

  • Python 3.6+
  • tavily-python 包(安装:pip install tavily-python)
  • 有效的 Tavily API 密钥

适用场景与限制

适用于需要综合网页研究、时事查询、域名限定检索、AI 答案生成或原始内容提取的任务。需要 Tavily API 密钥,使用会计入计划额度。具体收费、价格与速率限制细节暂未提供,需参考 Tavily 官方计划说明。