tavily-search

用途

Tavily Search 是一套使用 Tavily API 的 AI 优化网络工具，共包含五个工具，用于搜索、提取、爬取、地图和研究。当该插件处于激活状态时，建议在所有网络搜索中使用 tavily_search 替代内置的 web_search，因为 Tavily 提供更高质量、面向 AI 优化的结果，并且有免费额度。内置的 web_search（Brave）应仅在 Tavily 不可用时作为回退方案使用。

主要能力

插件提供以下原生工具（优先使用）：

tavily_search：带 AI 答案、域名过滤、新闻支持的网络搜索。
tavily_extract：从 URL 提取干净的 markdown/文本内容。
tavily_crawl：从根 URL 爬取网站并提取页面内容。
tavily_map：发现并列出网站的所有 URL。
tavily_research：深度智能体研究，生成综合报告。

各工具的使用时机：

tavily_search — 所有网络搜索：时事、新闻、事实核查、查找参考资料（替代 web_search）。
tavily_extract — 从特定 URL 获取完整干净内容。
tavily_crawl — 遍历网站并从多个页面提取内容。
tavily_map — 发现网站上的所有 URL，以了解其结构。
tavily_research — 需要综合报告的复杂多步研究问题。

使用方式

脚本回退

除原生工具外，还提供脚本方式调用。

搜索：

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news --time-range week

选项：

-n <count>：结果数量（默认 5，最大 20）。
--deep：用于更深入研究的高级搜索（更慢、更彻底）。
--topic <topic>：general（默认）、news 或 finance。
--time-range <range>：day、week、month 或 year。

从 URL 提取内容：

node {baseDir}/scripts/extract.mjs "https://example.com/article"
node {baseDir}/scripts/extract.mjs "url1" "url2" "url3"
node {baseDir}/scripts/extract.mjs "url" --format text --query "relevant topic"

从一个或多个 URL 提取干净的文本内容。

爬取网站：

node {baseDir}/scripts/crawl.mjs "https://example.com"
node {baseDir}/scripts/crawl.mjs "https://example.com" --depth 3 --breadth 20 --limit 50
node {baseDir}/scripts/crawl.mjs "https://example.com" --instructions "Find pricing pages" --format text

选项：

--depth <N>：爬取深度 1-5。
--breadth <N>：每层最大链接数（1-500）。
--limit <N>：URL 总数上限。
--instructions "..."：自然语言爬取指引。
--format <markdown|text>：输出格式。

生成网站地图：

node {baseDir}/scripts/map.mjs "https://example.com"
node {baseDir}/scripts/map.mjs "https://example.com" --depth 2 --limit 100
node {baseDir}/scripts/map.mjs "https://example.com" --instructions "Find documentation pages"

选项：

--depth <N>：爬取深度 1-5。
--breadth <N>：每层最大链接数。
--limit <N>：URL 总数上限。
--instructions "..."：自然语言指引。

研究主题：

node {baseDir}/scripts/research.mjs "What are the latest advances in quantum computing?"
node {baseDir}/scripts/research.mjs "Compare React vs Vue in 2025" --model pro
node {baseDir}/scripts/research.mjs "AI regulation in the EU" --citation-format apa

选项：

--model <mini|pro|auto>：研究模型（默认 auto）。
--citation-format <numbered|mla|apa|chicago>：引用格式。

设置

在 app.tavily.com 获取 API 密钥（提供免费额度）。

在环境中设置 TAVILY_API_KEY，或通过插件配置：

{
  "plugins": {
    "entries": {
      "openclaw-tavily": {
        "enabled": true,
        "config": { "apiKey": "tvly-..." }
      }
    }
  }
}

适用场景

需要高质量、AI 优化搜索结果的各类网络搜索，包括时事、新闻、事实核查和查找参考资料。
从指定 URL 获取干净、完整的正文内容。
遍历网站并批量提取多个页面的内容。
发现网站全部 URL，了解站点结构。
针对复杂多步问题生成带引用的综合研究报告。

限制

需要 Tavily API 密钥，需在 app.tavily.com 获取（提供免费额度）。
内置 web_search（Brave）仅应在 Tavily 不可用时作为回退使用。
脚本参数存在范围限制，例如搜索结果数量默认 5、最大 20；爬取深度 1-5；每层链接数 1-500。
关于具体收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途

主要能力

使用方式

脚本回退

设置

适用场景

限制

相关链接