Agent Skills
返回列表
Tavily AI 搜索 CLI

Tavily AI 搜索 CLI

数据分析 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4998424d/tavily-cli。

技能介绍

背景:Agent 需要可编排的联网能力

在对话里做调研时,常见痛点不是「能不能搜」,而是命令语义稳定、输出能直接进程序、以及多 URL / 整站场景下失败可局部交付。Tavily 提供搜索、提取与深度研究 API,本技能对应其中文 CLI 说明:命令与参数与英文版一致,面向在助手侧通过 shell 调用。

核心能力怎么落地

  • tavily search:带 search_depth、域名/时间过滤、include_answer 等,适合新闻或金融类检索。
  • tavily extract:对指定 URL 拉正文;多 URL 时成功项与 failed_results 分开展示,便于降级。
  • tavily map / tavily crawl:未知站点结构时建议先 map 发现链接再对选中页 extract,避免直接 crawl 的高额 credits。
  • tavily research:创建异步研究任务,默认 --wait 轮询;超时拿 request_id 用 tavily research get 续查,勿重复建任务。
  • 鉴权:从 TAVILY_API_KEY 或 ~/.tavily-cli/credentials/ 读取;Agent 调用应始终加 --json,以 {"ok":false,"error":{...}} 判错而非 exit code。

适用边界与注意点

advanced 深度搜索/提取为 2 credits,默认深度更省。限流与 server_error 文档约定最多 3 次退避重试。crawl 超时或部分页失败时,已爬结果仍应交付,勿为补缺页重复计费重爬。

使用场景

  • 助手需按时间窗与域名白名单抓取财经报道,用 `tavily search` 并输出 JSON 供后续汇总
  • 目标站栏目不清晰时,先 `tavily map` 列出内链,再对选定 URL 批量 `extract`
  • 用户给出多篇论文或博客链接,Agent 并行 `extract`,只对 `failed_results` 里的 URL 重试或说明原因
  • 需要一份带引用的长篇调研报告时,发起 `tavily research` 并在超时后用 `research get` 续查

适合人员

  • 搭建 Tool/Shell 技能的工程师,希望搜索与提取命令固定、响应一律 JSON
  • 做竞品与舆情快照的数据分析,需要域名过滤与时间范围可控的网络检索
  • 在助手里做课题调研的学生或研究员,要用 research 异步任务拿到结构化报告
  • 维护爬虫替代方案的自动化作者,想用 map→extract 控制 Tavily credits 消耗