Tavily Search 是为 AI 代理、自动化工作流 设计的高性能实时网络搜索工具，支持精准检索、深度网页提取和答案生成，必须配置 API 密钥才能使用。

---
## 工具名称
name: tavily-search
## 工具描述：基于 Tavily API 的智能网络搜索工具，专为 AI 代理优化
description: Smart web search tool powered by Tavily API, optimized for AI agents.
## 官方主页
homepage: https://tavily.com
## 工具元数据（用于 Clawdbot 集成）
metadata:
  clawdbot:
    # 工具图标
    emoji: "🔍"
    # 依赖要求：需要设置 Tavily API 密钥
    requires:
      env: ["TAVILY_API_KEY"]
    # 安装方式
    install:
      - id: pip
        kind: pip
        package: "tavily-python"
        bins: ["tavily"]
        label: "安装 Tavily Python SDK（pip 方式）"
---

👤 作者：arun-8687

👉 Skills 下载地址：tavily-search-1.0.0.zip

初始化配置（仅首次使用）

## 1. 安装 Tavily Python SDK
pip install tavily-python


## 2. 设置环境变量（配置 API 密钥，在 Tavily 官网申请获取）
## Linux / macOS
export TAVILY_API_KEY="你的Tavily_API_密钥"
## Windows (PowerShell)
$env:TAVILY_API_KEY="你的Tavily_API_密钥"

常用命令与代码示例

基础搜索（快速获取结果）

## 导入 Tavily Python SDK
from tavily import TavilyClient
import os


## 初始化客户端（从环境变量读取 API 密钥）
tavily = TavilyClient(api_key=os.getenv("TAVILY_API_KEY"))


## 执行基础搜索：查询关键词 + 最多返回5条结果
response = tavily.search(query="2026年人工智能发展趋势", max_results=5)


## 打印搜索结果
print("搜索标题：", response["results"][0]["title"])
print("搜索链接：", response["results"][0]["url"])
print("内容摘要：", response["results"][0]["content"])

深度搜索（获取完整网页内容）

## 深度搜索：include_raw_content=True 获取完整页面原文内容
response = tavily.search(
    query="Python 异步编程最佳实践",
    max_results=3,
    include_raw_content=True  # 启用深度内容提取
)


## 获取完整网页原文
full_content = response["results"][0]["raw_content"]

AI 智能问答（直接获取答案）

## Q&A 搜索：让 AI 直接总结答案，无需手动阅读网页
answer = tavily.qna_search(query="Explain quantum computing in simple terms")
## 输出 AI 总结后的简洁答案
print("简洁答案：", answer)

高级搜索（精准过滤）

## 高级搜索配置
response = tavily.search(
    query="机器学习教程",
    max_results=5,
    search_depth="advanced",  # 高级搜索深度
    include_domains=["github.com", "medium.com"],  # 限定域名
    exclude_domains=["wikipedia.org"],  # 排除域名
    include_answer=True  # 包含 AI 生成的直接答案
)

API 调用参数说明

参数	说明
query	搜索关键词/问题（必填）
max_results	最大返回结果数（默认 5）
search_depth	搜索深度：basic / advanced
include_raw_content	是否获取完整网页内容（True/False）
include_answer	是否让 AI 生成简洁答案（True/False）
include_domains	仅搜索指定域名列表
exclude_domains	排除指定域名列表

使用注意事项

## 1. 永久配置环境变量（推荐）
## Linux/macOS: 写入 ~/.bashrc 或 ~/.zshrc
echo 'export TAVILY_API_KEY="你的密钥"' >> ~/.zshrc
source ~/.zshrc

1. API 密钥：必须在 Tavily 官网 注册获取免费密钥。
2. 使用场景：适合实时信息检索、事实核查、文档资料获取、AI 问答。
3. 脚本推荐：
   • 使用 qna_search() 快速获取答案
   • 深度搜索使用 include_raw_content 获取完整内容
   • 限定域名可大幅提高搜索准确性
4. 速率限制：免费版有请求次数限制，付费版可提升配额。
5. 结果格式：返回结构化 JSON，可直接用于 AI 代理、自动化流程。

补充信息

• 官方地址：https://clawhub.ai/arun-8687/tavily-search
• 开发语言：Python
• 适用平台：全平台（macOS / Linux / Windows）
• 核心优势：专为 AI 优化、速度快、支持深度抓取、自带智能总结