tavily

name	tavily
description	【首选搜索工具】Tavily AI 搜索，专为 AI Agent 优化，返回高质量摘要和来源，搜索结果比 web-search/multi-search-engine 更准确、更快。触发词：搜索、查一下、帮我找、search、找资料、查数据、查文献、最新消息、新闻、调研、research、查询、检索。注意：需要 API Key（tvly-xxxx）。未配置时降级使用 multi-search-engine。
allowed-tools	["Bash","mcp__tavily__tavily_search","mcp__tavily__tavily_extract","WebFetch"]

Tavily AI Search

专为 AI Agent 设计的搜索引擎，相比通用 WebSearch 有以下优势：

• 直接返回摘要内容，无需解析 HTML
• 针对 LLM 优化的相关性排序
• 同时支持网页搜索 + URL 内容提取
• 每次调用返回结构化 JSON，包含标题、URL、内容片段、评分

---

⚙️ 配置（首次使用必读）

第一步：获取 API Key

访问 https://app.tavily.com 注册，免费额度每月 1000 次。

第二步：添加 MCP Server

claude mcp add tavily -s user -e TAVILY_API_KEY=tvly-你的key -- npx -y tavily-mcp

第三步：验证

claude mcp list

确认看到 tavily 出现在列表中即可。

---

🔧 MCP 工具说明

mcp__tavily__tavily_search — 网页搜索

参数	类型	说明
query	string	搜索词，支持自然语言
search_depth	"basic" / "advanced"	basic 免费，advanced 更深度
max_results	number	返回结果数（默认 5，最多 10）
include_answer	boolean	是否包含 AI 生成的摘要（默认 true）
include_raw_content	boolean	是否包含原始页面文本
include_domains	string[]	限制搜索域名（如 ["reuters.com"]）
exclude_domains	string[]	排除域名
topic	"general" / "news"	general 通用，news 实时新闻
days	number	仅 topic=news 时有效，查最近 N 天

mcp__tavily__tavily_extract — URL 内容提取

参数	类型	说明
urls	string[]	要提取内容的 URL 列表（最多 20 个）

---

📋 标准执行流程

通用研究型搜索

1. 分析用户意图，提炼 2-3 个搜索关键词
2. 调用 tavily_search(query, search_depth="basic", max_results=5)
3. 读取 answer 字段（AI 摘要）+ results 数组（来源列表）
4. 如需深入某个来源：调用 tavily_extract(urls=[...])
5. 综合整理，附上来源链接

实时新闻搜索

1. 调用 tavily_search(query, topic="news", days=7, max_results=8)
2. 按发布时间排序结果
3. 汇总关键信息

多角度研究（高质量输出）

1. 第一轮：broad 搜索，了解全貌
2. 第二轮：针对关键子问题的 advanced 搜索
3. 第三轮：对核心来源做 tavily_extract 获取完整内容
4. 综合 3 轮结果输出

---

📦 返回结构

{
  "answer": "AI 直接生成的摘要答案",
  "results": [
    {
      "title": "文章标题",
      "url": "https://...",
      "content": "摘要片段（约 200 字）",
      "score": 0.92,
      "published_date": "2025-05-29"
    }
  ],
  "response_time": 1.23
}

---

🔄 降级策略（API Key 未配置时）

若 MCP 工具不可用，自动降级：

1. 优先用 multi-search-engine skill（DuckDuckGo → Bing）
2. 无法访问时用 WebSearch 内置工具

---

💡 使用示例

中文研究

用户："帮我搜索歌华有线2025年最新财报信息"
→ tavily_search(query="歌华有线 2025 财报", topic="news", days=90)

英文技术资料

用户："查一下 Claude API 最新的 rate limits"
→ tavily_search(query="Anthropic Claude API rate limits 2025", include_domains=["docs.anthropic.com"])

竞品调研

用户："调研国内主要有线电视运营商的AI战略"
→ 第一轮：tavily_search("中国有线电视运营商 AI 战略 2025")
→ 第二轮：tavily_search("歌华有线 华数传媒 东方有线 数字化转型")
→ 提取核心页面：tavily_extract(urls=[...])