智能体已经存在于终端中。当它们需要网络数据时，应该能够运行一条命令——这正是 Tavily CLI 所实现的功能。

搜索、提取、爬取和研究都返回结构化输出，智能体可以直接解析，无需清理 HTML 或额外抓取中间层。

一行命令安装，智能体就拥有了实时网络访问能力，可集成到你运行的任何循环中。

https://docs.tavily.com/documentation/tavily-cli…

Tavily CLI - Tavily 文档

来源: https://docs.tavily.com/documentation/tavily-cli Tavily CLI (tvly) 将完整的 Tavily API 带到你的命令行。运行网络搜索、提取 URL 内容、爬取网站、发现站点地图以及启动深度研究——一切尽在单一工具。每个命令都支持 --json 以输出机器可读的结果，便于集成到脚本、流水线和 AI 智能体工作流中。

安装

使用官方安装器安装：

curl -fsSL https://cli.tavily.com/install.sh | bash

或手动安装：

uv tool install tavily-cli # 或者: pip install tavily-cli

验证安装：

认证

你需要一个 Tavily API 密钥来使用 CLI。在 tavily.com (https://tavily.com/) 免费获取一个。

检查认证状态

登出

这会从磁盘中移除已存储的凭据。

会话追踪

CLI 会自动为每个运行的命令附加一个唯一的 session_id，这样来自同一次 shell 调用的请求可以分组在一起。这适用于 tvly search、extract、crawl、map 和 research。如果想将请求与特定最终用户关联，可以设置 TAVILY_HUMAN_ID 环境变量：

export TAVILY_HUMAN_ID=h_4f9ac

或者，在 ~/.tavily/config.json 中添加 human_id 字段——如果两者都设置，环境变量优先级更高。出于安全考虑，Tavily 在处理或存储 human ID 之前会对其进行哈希处理。详见 API 参考中的会话追踪 (https://docs.tavily.com/documentation/api-reference/introduction#session–user-tracking)。

命令

交互模式

不带参数运行 tvly 即可进入交互式 REPL，无需 tvly 前缀即可运行命令：

❯ search "latest AI news" ❯ extract https://example.com ❯ exit

全局选项

这些选项适用于顶级 tvly 命令：

tvly --version tvly --status tvly search --help

JSON 模式

在任何命令后添加 --json 即可获得机器可读的 JSON 输出。这对于通过管道传递给 jq 等其他工具，或集成到脚本和 AI 智能体工作流中非常有用。

``

通过 jq 管道传递搜索结果

tvly search “AI news” –json | jq ‘.results[].title’

在 shell 脚本中使用

RESULTS=$(tvly search “latest papers on RAG” –json) ``

所有人类可读的输出（旋转指示器、状态消息）会写入 stderr，因此使用 --json 时，stdout 只包含干净的 JSON。

环境变量

退出码

卸载

同时移除已存储的凭据：

rm -rf ~/.tavily ~/.mcp-auth