Tavily Search 是一个联网搜索技能,通过 Tavily 的 LLM 优化 API 返回结构化搜索结果。相比普通网页搜索,它在需要结构化相关性评分、域名过滤或时间范围过滤时更合适,且无需启动本地浏览器。
主要能力
- 返回结果包含标题、URL、内容摘要和相关性评分(score,0–1)。
- 支持搜索深度选择:ultra-fast、fast、basic(默认)、advanced,用于在延迟与结果质量之间取舍。
- 支持时间过滤:time_range(day / week / month / year)以及 start_date、end_date(YYYY-MM-DD)。
- 支持域名控制:include_domains(最多 300 个)限定来源,exclude_domains(最多 150 个)排除来源。
- 支持按国家加权结果(country)。
- 可选返回完整页面内容(include_raw_content)和图片结果(include_images)。
- 可设置返回结果数量 max_results(1–20,默认 10)。
使用方式
需先配置认证:在 ~/.openclaw/.env.local 中设置 TAVILY_API_KEY,例如 TAVILY_API_KEY=tvly-your-api-key-here。密钥可在 https://tavily.com 获取,每月提供 1,000 免费额度。
接口为 POST https://api.tavily.com/search,请求头包含 Authorization: Bearer $TAVILY_API_KEY 和 Content-Type: application/json。基础调用示例:
curl -s -X POST https://api.tavily.com/search
-H "Authorization: Bearer $TAVILY_API_KEY"
-H "Content-Type: application/json"
-d '{"query": "latest Claude model releases 2025", "max_results": 5}'
响应格式包含 query、results 数组(每项含 title、url、content、score)以及 response_time。
适用场景
- 查找超出知识截止时间的当前新闻、事件或信息。
- 从可信或指定域名研究某个主题。
- 时间限定查询,例如“过去一周”“过去一个月”。
- 需要相关性评分来排序和过滤结果时。
- 快速事实查询,使用浏览器自动化显得过重时。
使用建议与限制
- 查询词建议保持在 400 字符以内,应视为搜索词而非提示词。
- 复杂主题可拆分为多个有针对性的子查询。
- 可用 include_domains 聚焦权威来源。
- 可用 score 字段过滤低相关结果,例如丢弃低于 0.5 的结果。
- 用户询问近期事件或新闻时使用 time_range。
- 当结果质量比速度更重要时,建议使用 advanced 深度。
- 若需要深度多来源综合或市场分析,资料建议优先使用 tavily-research。
其他信息(如具体收费方案、平台支持范围等)暂未提供。