tavily

Tavily

面向 AI 优化的搜索引擎，利用实时网络数据构建大模型应用。

链接

• 文档
• 发行记录
• GitHub
• PyPI

快速导航

主题	参考资料
REST API	api.md
Python SDK	python.md
JavaScript SDK	javascript.md
最佳实践	best-practices.md
集成	integrations.md

适用场景

• 利用实时网络数据构建 RAG 应用
• 需要最新信息的 AI Agent
• 从网页中提取内容
• 根据 AI 指令抓取网站
• 自主研究任务

安装

安装：pip install tavily-python（Python）或 npm i @tavily/core（JavaScript）。

快速入门

Python

from tavily import TavilyClient

client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = client.search("What is the latest news about AI?")
print(response)

JavaScript

import { tavily } from "@tavily/core";

const client = tavily({ apiKey: "tvly-YOUR_API_KEY" });
const response = await client.search("What is the latest news about AI?");
console.log(response);

cURL

curl -X POST https://api.tavily.com/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{"query": "What is the latest news about AI?"}'

核心 API

API	用途	点数
Search	面向大模型优化的网络搜索	每次请求 1-2 点
Extract	从 URL 提取内容	每 5 个 URL 1-2 点
Map	获取网站结构	每 10 个页面 1-2 点
Crawl	抓取网站并提取内容	Map + Extract
Research	自主深度研究（测试版）	每项任务 4-250 点

定价与点数

**免费套餐：**每月 1,000 点（无需信用卡）

套餐	每月点数	每点价格
Researcher	1,000	免费
Project	4,000	$0.0075
Bootstrap	15,000	$0.0067
Startup	38,000	$0.0058
Growth	100,000	$0.005
Pay-as-go	按使用量计费	$0.008

点数成本

API	基础	高级
Search	1	2
Extract	每 5 个 URL 1 点	每 5 个 URL 2 点
Map	每 10 个页面 1 点	每 10 个页面 2 点
Crawl	Map + Extract 成本
Research (mini)	4-110	-
Research (pro)	15-250	-

速率限制

环境	RPM（请求/分钟）
开发环境	100
生产环境	1,000

**注意：**两个环境中的 Crawl 端点均限制为 100 RPM。

生产密钥需要付费套餐或启用 PAYGO。

Search API

用于面向大模型优化的网络搜索的主要端点。

response = client.search(
    query="Latest AI developments",
    search_depth="advanced",      # "basic" (1 credit) or "advanced" (2 credits)
    max_results=10,               # 1-20 results
    include_answer=True,          # Include AI-generated answer
    include_raw_content=False,    # Include raw HTML
    include_domains=["arxiv.org"],  # Filter to specific domains
    exclude_domains=["pinterest.com"]  # Exclude domains
)

响应结构

{
    "query": "...",
    "answer": "AI-generated summary...",  # if include_answer=True
    "results": [
        {
            "title": "Page Title",
            "url": "https://...",
            "content": "Extracted relevant content...",
            "score": 0.95,
            "raw_content": "..."  # if include_raw_content=True
        }
    ]
}

Extract API

从指定 URL 提取内容。

response = client.extract(
    urls=["https://example.com/article1", "https://example.com/article2"],
    extract_depth="basic"  # "basic" or "advanced"
)

Crawl API

根据 AI 指令抓取网站。

response = client.crawl(
    url="https://docs.example.com",
    instructions="Find all pages about Python SDK",  # Optional AI guidance
    max_depth=2,
    limit=50
)

Map API

获取网站结构，不提取内容。

response = client.map(
    url="https://docs.example.com",
    instructions="Find documentation pages"  # Optional
)

Research API（测试版）

针对复杂主题进行自主深度研究。

response = client.research(
    input="What are the implications of quantum computing on cryptography?",
    model="pro"  # "pro" (15-250 credits) or "mini" (4-110 credits)
)

为什么选择 Tavily？

特性	传统搜索	Tavily
输出	URL + 摘要	完整内容
抓取	手动	内置
大模型优化	无	专为此设计
筛选	手动	AI 驱动
上下文限制	不处理	已优化

最佳实践

1. 对简单查询使用 search_depth="basic"（节省额度）
2. 使用 include_answer=True 获取快速摘要
3. 筛选域名以提高相关性
4. 知道特定 URL 时使用 Extract
5. 对复杂的多步骤查询使用 Research
6. 仅在试用时使用 Python 免密模式；它仅支持 search() 和 extract()，且仍受速率限制

禁止事项

• 不要在客户端代码中暴露 API 密钥

• 不要超出速率限制（请实现退避机制）

• 不要抓取会阻止 Tavily 爬虫访问的网站

• API Playground

• 文档

• 社区