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 密钥
- 访问 https://tavily.com
- 注册账号
- 进入仪表板
- 生成 API 密钥(以 tvly- 开头)
- 注意所在计划的速率限制和额度分配
常见使用场景
研究与事实查证
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。
最佳实践
- 选择合适的搜索深度:多数查询先用 basic(更快、更省);仅当初始结果不足、主题复杂或需要全面覆盖时升级到 advanced。
- 策略性地使用域名过滤:包含域名用于学术研究(.edu 域名)、官方文档、可信新闻源和已知权威来源;排除域名用于已知低质量内容农场、无关内容类型以及有付费墙或访问限制的网站。
- 优化成本:默认使用 basic 深度,限制 max_results 为实际需要的数量,除非必要不启用 include_raw_content,对重复查询进行本地缓存。
- 优雅处理错误:脚本提供有用的错误信息,如缺少 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 官方计划说明。