Tavily AI 搜索 CLI
将以下提示词粘贴到你的 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 消耗