Tavily Search 极简版

【极简版省token】使用 Tavily API 执行网络搜索。专为 LLM 与 AI Agent 优化的搜索引擎。

Tavily Search

使用 Tavily API 在互联网上搜索并总结最新信息。本工具会向 https://api.tavily.com/search 发起网络请求。

配置环境变量与凭据

此脚本需要 Tavily API 密钥才能运行。请配置 TAVILY_API_KEY 环境变量（或将其写入 ~/.openclaw/.env）：

export TAVILY_API_KEY="your_api_key_here"

使用方法

python3 scripts/tavily_search.py --query "你的搜索词" [--search-depth advanced] [--max-results 5]

参数名	类型	必填	默认值	描述
query	string	是	-	搜索关键词
search-depth	string	否	basic	搜索深度：basic (基础, 1积分), advanced (高级, 2积分), fast (快速), ultra-fast (极速)
topic	string	否	general	主题分类：general (通用), news (新闻), finance (金融)
country	string	否	-	国家/地区（小写英文全名，如 china,united states,singapore，完整合法取值见 scripts/tavily_search.py 中 TAVILY_COUNTRY_CHOICES）；仅 topic=general 生效
time-range	string	否	-	时间过滤：day, week, month, year (或简写 d, w, m, y)
start-date	string	否	-	起始日期，格式如 YYYY-MM-DD
end-date	string	否	-	结束日期，格式如 YYYY-MM-DD
max-results	int	否	5	返回结果数量限制（0-20）
include-images	bool	否	False	是否在结果中包含查询相关的图片
include-domains	string	否	-	仅搜索指定域名（多个用逗号分隔）
exclude-domains	string	否	-	排除指定域名（多个用逗号分隔）
chunks-per-source	int	否	3	每个来源提取的文本块数量 (1-3，仅在 depth 为 advanced/fast 时有效)
auto-parameters	bool	否	False	开启后，Tavily 会根据查询意图自动覆盖及配置搜索参数
format	string	否	raw	输出格式控制：raw (原始JSON), brave (极简JSON), md (人类可读)

License

MIT License - Feel free to use and modify.