SuperAPI AI 工具集

tavily-search

通用与其它

查看项目

更新于 10-16 09:38

技能介绍

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。

其他信息(如具体收费方案、平台支持范围等)暂未提供。