Tavily Search: 大模型联网搜索智能体

Tavily Search 是一款针对大型语言模型（LLM）和智能体（Agent）设计的智能搜索引擎，通过实时数据检索和检索增强生成（RAG）技术，为 AI 应用提供精准、高效的信息支持。其核心功能包括：单次 API 调用聚合多源数据（支持 20+ 权威来源）、定制化搜索（如领域限制、时间范围筛选）、结构化结果输出（含引用溯源），并深度集成 LangChain 等框架，适用于实时数据增强、企业研究、内容生成等场景。与 Jina AI 等平台相比，Tavily 专注于实时信息检索优化，开发者可通过 Python/JavaScript 快速调用，免费提供每月 1,000 次查询。而且，Tavily支持直接在线注册并使用，而大多数其他类似工具在国内则无法直接访问。

在开始之前，需要访问“获取API密钥”页面，注册并登录Tavily平台以取得API密钥。

1. python直接调用

为了安装Tavily的Python包，请按照以下步骤操作：

1. 打开终端或命令行界面。
2. 运行以下pip命令来安装Tavily库：

pip install tavily

确认安装过程无误后，就可以在项目中导入并使用Tavily的相关功能了。

from tavily import TavilyClient
tavily_client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = tavily_client.search("今天北京的天气怎么样？")
print(response)

2. Langchain调用Tavily Search的API

2.1. 安装langchain-tavily

pip install langchain-tavily

2.2. 检索

import getpass
import os
from langchain_community.tools.tavily_search import TavilySearchResults

if not os.environ.get("TAVILY_API_KEY"):
    os.environ["TAVILY_API_KEY"] = getpass.getpass("Tavily API key:tvly-YOUR_API_KEY")

# 搜索（免费用户每月仅1000次的搜索额度哦！）
search = TavilySearchResults(
    max_results=1，
    topic="general",
    # include_answer=False,
    # include_raw_content=False,
    # include_images=False,
    # include_image_descriptions=False,
    # search_depth="basic",
    # time_range="day",
    # include_domains=None,
    # exclude_domains=None
)
print(search.invoke("今天北京的天气怎么样？"))

3. MCP调用 （Windows+Cursor）

Tavily 支持通过模型上下文协议 Model Context Protocol (MCP) 调用，使其能够无缝集成到支持 MCP 的客户端（如 Cursor、Claude桌面、WindSurf、Cline），提供 AI 搜索能力。通过 MCP 服务器，Tavily 可实现多维度搜索控制（如限定时间范围、过滤域名、调整结果数量等），并支持 AI 生成的摘要和结构化结果输出，可以应用于优化 RAG和 LLM 的实时信息检索。用户只需配置 API 密钥即可快速部署，适用于开发环境、研究分析等场景。MCP安装可以参考：tavily-mcp

3.1. MCP调用依赖安装

1. Tavily API key
2. Cursor （或Claude桌面、WindSurf、Cline）
3. 安装Node.js

3.2. npx安装Tavily

npx -y tavily-mcp@0.1.3

npx安转后报错如下：

npx : 无法加载文件 C:\Program Files\nodejs\npx.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅https:/go.microsoft.com/fwlink/?LinkID=135170](http://t.com/fwlink/?LinkID=135170) 中的about_Execution_Policies。
所在位置 行:1 字符: 1

• npx
• + CategoryInfo : SecurityError: (:) []，PSSecurityException + FullyQualifiedErrorId : UnauthorizedAccess

解决方案：
在powershell中执行：

get-ExecutionPolicy

返回 Restricted 说明状态是禁止的。可以通过set-ExecutionPolicy修改状态。

set-ExecutionPolicy RemoteSigned

弹出弹框，点击“是”即可。

3.3. 在Cursor中配置MCP客户端

注意: 需要 Cursor 版本大于 0.45.6

1. 打开 Cursor设置（Cursor Settings）→ MCP Servers
2. 点击“+ Add New MCP Server”按钮
3. 在mcp.json文件填写下列信息：

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@0.1.3"],
      "env": {
        "TAVILY_API_KEY": "tvly-YOUR_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意替换"TAVILY_API_KEY"为自己的key即可。

4. 价格