Tavily Search (Enhanced)#

AI-optimized web search via Tavily API. Enhanced version with full official API parameter support.

主要用途: 交叉验证 Scout 调研结果的事实准确性，而非替代 Scout 做调研。

Usage#

bash

node {baseDir}/scripts/search.mjs "query" [options]

Options#

OptionDescriptionDefault-n <count>Max results (1-20)5--deepAdvanced search (更准确，2 credits)basic--topic <t>``general | news | financegeneral--time-range <r>``day | week | month | year无限制--start-date <d>YYYY-MM-DD (结果起始日期)—--end-date <d>YYYY-MM-DD (结果截止日期)—--include-domains <d>逗号分隔，限定搜索域名—--exclude-domains <d>逗号分隔，排除域名—--exact精确匹配引号内短语false--country <name>提升特定国家结果 (china/united states/japan)—--images包含图片结果false--raw包含页面原始 markdown 内容false--json输出原始 JSON（供脚本消费）false

Fact-Check Examples#

验证某个具体事实:

bash

node {baseDir}/scripts/search.mjs "武侯祠 建于哪一年" --exact --include-domains baike.baidu.com,zh.wikipedia.org -n 3

验证最新新闻:

bash

node {baseDir}/scripts/search.mjs "成都大庙会 2026" --topic news --time-range month -n 5

验证金融数据:

bash

node {baseDir}/scripts/search.mjs "MiniMax 融资 估值" --topic finance --time-range year

深度调研 + 限定来源:

bash

node {baseDir}/scripts/search.mjs "川剧变脸 历史 起源" --deep --country cn -n 10

When To Use#

• ✅ Scout 返回的调研结果 → 用 Tavily 交叉验证关键事实
• ✅ 推文/内容生产 → 验证引用的数据、日期、名称是否准确
• ✅ 时效性信息 → --topic news --time-range week 获取最新
• ❌ 不要用于替代 Scout 做全面调研 — Scout 有更完整的搜索+分析能力

vs Upstream tavily-search#

FeatureUpstreamThis versiontime_range / start_date / end_date❌ (deprecated days)✅include_domains / exclude_domains❌✅exact_match❌✅finance topic❌✅country boost❌✅include_images❌✅raw content (markdown)❌✅JSON output mode❌✅const/require bugs⚠️ 2 bugs✅ FixedResponse timing❌✅

Environment#

• TAVILY_API_KEY env var, or in ~/.openclaw/.env / ~/.env
• Cost: 1 credit (basic) / 2 credits (advanced/deep)