用途:Tavily 是专为 AI Agent 优化的搜索 API,返回干净、结构化的结果,适合 LLM 直接消费。使用场景包括需要高质量搜索结果用于调研、写作等复杂任务;在 ddg-search 结果不够精确时作为升级选项;以及作为 deep-research 流程中的搜索后端。
前置条件:需设置环境变量 TAVILY_API_KEY。访问 https://tavily.com/ 注册(免费套餐每月 1000 次),设置:export TAVILY_API_KEY="tvly-xxxxx"。
执行方式:支持 REST API 与 Python SDK。基本搜索用 curl -s -X POST "https://api.tavily.com/search" 并传入 api_key、query、search_depth、max_results;深度搜索可将 search_depth 设为 advanced、max_results 设为 10 并开启 include_raw_content。Python SDK 需 from tavily import TavilyClient,用 client.search(query=..., search_depth=..., max_results=...) 调用并遍历 response["results"]。
参数:search_depth 取 basic / advanced,basic 快但浅,advanced 慢但全;max_results 为 1-20;include_raw_content 为布尔值,决定是否返回网页原始内容;include_domains 限定搜索域名;exclude_domains 排除域名。
输出规范:搜索结果标注来源 URL 和相关度分数,advanced 用于深度调研,basic 用于快速查询。限制:免费额度有限,简单查询优先用 ddg-search。其它收费、价格、平台与效果信息暂未提供。