Tavily 搜索 🔎

一个具备5种模式的AI驱动网络搜索平台：搜索、提取、抓取、映射和研究。

要求

• TAVILY_API_KEY环境变量

配置

在 OpenClaw 配置中设置：

{
  "env": {
    "TAVILY_API_KEY": "tvly-..."
  }
}

脚本位置

python3 skills/tavily/lib/tavily_search.py <command> "query" [options]

命令

search — 网络搜索（默认）

通用网络搜索，可选择生成由LLM合成的答案。

python3 lib/tavily_search.py search "query" [options]

示例：

# Basic search
python3 lib/tavily_search.py search "latest AI news"

# With LLM answer
python3 lib/tavily_search.py search "what is quantum computing" --answer

# Advanced depth (better results, 2 credits)
python3 lib/tavily_search.py search "climate change solutions" --depth advanced

# Time-filtered
python3 lib/tavily_search.py search "OpenAI announcements" --time week

# Domain filtering
python3 lib/tavily_search.py search "machine learning" --include-domains arxiv.org,nature.com

# Country boost
python3 lib/tavily_search.py search "tech startups" --country US

# With raw content and images
python3 lib/tavily_search.py search "solar energy" --raw --images -n 10

# JSON output
python3 lib/tavily_search.py search "bitcoin price" --json

输出格式（文本）：

Answer: <LLM-synthesized answer if --answer>

Results:
  1. Result Title
     https://example.com/article
     Content snippet from the page...

  2. Another Result
     https://example.com/other
     Another snippet...

news — 新闻搜索

专为新闻文章优化的搜索。设置topic=新闻。

python3 lib/tavily_search.py news "query" [options]

示例：

python3 lib/tavily_search.py news "AI regulation"
python3 lib/tavily_search.py news "Israel tech" --time day --answer
python3 lib/tavily_search.py news "stock market" --time week -n 10

finance — 金融搜索

针对金融数据和新闻优化的搜索。设置topic=finance。

python3 lib/tavily_search.py finance "query" [options]

示例：

python3 lib/tavily_search.py finance "NVIDIA stock analysis"
python3 lib/tavily_search.py finance "cryptocurrency market trends" --time month
python3 lib/tavily_search.py finance "S&P 500 forecast 2026" --answer

extract — 从 URL 提取内容

从一个或多个 URL 提取可读内容。

python3 lib/tavily_search.py extract URL [URL...] [options]

参数：

• urls：要提取的一个或多个 URL（位置参数）
• --depth basic|advanced：提取深度
• --format markdown|text：输出格式（默认：markdown）
• --query "文本"：根据与查询的相关性对提取的文本块进行重新排序

示例：

# Extract single URL
python3 lib/tavily_search.py extract "https://example.com/article"

# Extract multiple URLs
python3 lib/tavily_search.py extract "https://url1.com" "https://url2.com"

# Advanced extraction with relevance reranking
python3 lib/tavily_search.py extract "https://arxiv.org/paper" --depth advanced --query "transformer architecture"

# Text format output
python3 lib/tavily_search.py extract "https://example.com" --format text

输出格式：

URL: https://example.com/article
─────────────────────────────────
<Extracted content in markdown/text>

URL: https://another.com/page
─────────────────────────────────
<Extracted content>

crawl — 爬取网站

从根 URL 开始爬取网站，跟随链接。

python3 lib/tavily_search.py crawl URL [options]

参数：

• url开始爬取的根URL
• --depth basic|advanced爬取深度
• --max-depth N要跟随的最大链接深度（默认值：2）
• --max-breadth N每个深度级别的最大页面数（默认值：10）
• --limit N最大总页面数（默认值：10）
• --instructions "文本"自然语言爬取指令
• --select-paths p1,p2仅爬取这些路径模式
• --exclude-paths p1,p2跳过这些路径模式
• --format markdown|text输出格式

示例：

# Basic crawl
python3 lib/tavily_search.py crawl "https://docs.example.com"

# Focused crawl with instructions
python3 lib/tavily_search.py crawl "https://docs.python.org" --instructions "Find all asyncio documentation" --limit 20

# Crawl specific paths only
python3 lib/tavily_search.py crawl "https://example.com" --select-paths "/blog,/docs" --max-depth 3

输出格式：

Crawled 5 pages from https://docs.example.com

Page 1: https://docs.example.com/intro
─────────────────────────────────
<Content>

Page 2: https://docs.example.com/guide
─────────────────────────────────
<Content>

map — 网站地图发现

发现网站上的所有URL（网站地图）。

python3 lib/tavily_search.py map URL [options]

参数：

• url要映射的根URL
• --max-depth N: 要跟踪的深度（默认值：2）
• --max-breadth N: 每层广度（默认值：20）
• --limit N: 最大URL数（默认值：50）

示例：

# Map a site
python3 lib/tavily_search.py map "https://example.com"

# Deep map
python3 lib/tavily_search.py map "https://docs.python.org" --max-depth 3 --limit 100

输出格式：

Sitemap for https://example.com (42 URLs found):

  1. https://example.com/
  2. https://example.com/about
  3. https://example.com/blog
  ...

research — 深度研究

基于AI对某个主题的全面研究，并附有引用。

python3 lib/tavily_search.py research "query" [options]

参数：

• query: 研究问题
• --model mini|pro|auto: 研究模型（默认值：auto）
  • mini: 更快、更便宜
  • pro: 更彻底
  • auto: 让Tavily决定
• --json: JSON输出（支持结构化输出模式）

示例：

# Basic research
python3 lib/tavily_search.py research "Impact of AI on healthcare in 2026"

# Pro model for thorough research
python3 lib/tavily_search.py research "Comparison of quantum computing approaches" --model pro

# JSON output
python3 lib/tavily_search.py research "Electric vehicle market analysis" --json

输出格式：

Research: Impact of AI on healthcare in 2026

<Comprehensive research report with citations>

Sources:
  [1] https://source1.com
  [2] https://source2.com
  ...

选项参考

错误处理

• 缺少API密钥：显示清晰的错误信息，并提供设置说明。
• 401 未授权：无效的API密钥。
• 429 速率限制：超出速率限制，请稍后再试。
• 网络错误：提供包含原因的详细错误信息。
• 无结果：显示简洁的“未找到结果。”信息。
• 超时：所有HTTP请求设置30秒超时。

积分与定价

安装

bash skills/tavily/install.sh