tavily-search

tavily search

返回经过大模型优化的网页搜索结果，包含内容摘要和相关性评分。

运行前

如果 tvly 可用，直接运行搜索。搜索支持有上限的免密钥访问，因此首次请求前不要查找 API 密钥或进行身份验证。

如果找不到 tvly，请按照 tavily-cli setup 中的说明完成设置，然后重试。如果在交互式会话中达到免密钥访问上限，请运行 tvly login 打开浏览器 OAuth，然后重试一次原始搜索。在无人值守环境中，请报告访问上限和身份验证选项，而不要启动交互流程。引导式设置完成后，不要立即再次登录。

适用场景

• 需要查找任何主题的信息
• 还没有具体的 URL
• 工作流中的第一步：搜索 → 提取 → 映射 → 抓取 → 研究

快速开始

# Basic search
tvly search "your query" --json

# Advanced search with more results
tvly search "quantum computing" --depth advanced --max-results 10 --json

# Recent news
tvly search "AI news" --time-range week --topic news --json

# Domain-filtered
tvly search "SEC filings" --include-domains sec.gov,reuters.com --json

# Include full page content in results
tvly search "react hooks tutorial" --include-raw-content --max-results 3 --json

选项

选项	说明
--depth	ultra-fast、fast、basic（默认）或 advanced
--max-results	结果数上限，0-20（默认：5）
--topic	general（默认）、news、finance
--time-range	day、week、month、year
--start-date	此日期之后的结果（YYYY-MM-DD）
--end-date	此日期之前的结果（YYYY-MM-DD）
--include-domains	要包含的域名，以逗号分隔
--exclude-domains	要排除的域名，以逗号分隔
--country	提升来自该国家/地区的结果排名
--include-answer	包含 AI 答案（basic 或 advanced）
--include-raw-content	包含完整页面内容（markdown 或 text）
--include-images	包含图片结果
--include-image-descriptions	包含 AI 图片描述
--chunks-per-source	每个来源的分块数（仅适用于 advanced/fast 深度）
-o, --output	将 JSON 响应保存到文件
--json	结构化 JSON 输出

搜索深度

深度	速度	相关性	适用场景
ultra-fast	最快	较低	实时聊天、自动补全
fast	快	良好	需要分块且延迟很重要
basic	中等	高	通用场景（默认）
advanced	较慢	最高	精准搜索、特定事实

提示

• 将查询控制在 400 个字符以内——把它当作搜索查询，而不是提示词。
• 将复杂查询拆分为多个子查询，以获得更好的结果。
• 需要完整页面文本时使用 --include-raw-content（可省去单独调用 extract）。
• 使用 --include-domains 聚焦可信来源。
• 使用 --time-range 查找近期信息。
• 在确切的第一手来源核实对身份敏感的信息。 对于发布、版本、所有权或名称相似的项目，应确认官方仓库或域名，而不要只相信生成的答案或仅凭软件包名称匹配。
• 从标准输入读取：echo "query" | tvly search - --json

另请参阅

• tavily-extract — 从指定 URL 提取内容
• tavily-research — 跨多个来源开展全面研究