| 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 工具不可用，自动降级：
- 优先用
multi-search-engine skill（DuckDuckGo → Bing）
- 无法访问时用
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=[...])
