技能介绍

背景：Tavily 技能碎片化

在 WorkBuddy 里接 Tavily，常见痛点不是「有没有搜索」，而是入口和输出各说各话：同名变体一堆（tavily-search、tavily-websearch 等），有的只有 search，有的缺 research 或用量查询；返回有时是纯文本、有时是 JSON，Agent 很难稳定解析。文档里还常缺限流、信用点、auto_parameters 这类踩坑说明。

技能如何工作

本技能把 Tavily 的 Search / Extract / Crawl / Map / Research 以及 usage 收进同一套 CLI，并约定标准 JSON 输出，方便 WorkBuddy 按字段取 results[].url、分数和引用。

search：支持 general / news / finance，可调 search-depth、time-range、域名过滤等；默认宜 basic + 较少 max-results。
extract：对已知 URL 做结构化抓取，可用 --query 做关键词重排，适合「先搜后抓」的第二阶段。
crawl / map：前者按深度与路径规则整站遍历；后者只做 URL 发现，不拉正文，适合盘站点结构。
research：异步多轮研究，可指定引用格式（如 numbered / APA），需轮询直至完成。

认证只读环境变量 TAVILY_API_KEY；API 基址固定为 https://api.tavily.com，并拒绝意外 redirect，降低 Key 泄露风险。

适用边界与注意点

成本：advanced 深度与 include-raw-content 会显著增加信用点与输出体积；大段原文应走 search → extract，不要在 search 上直接开全量 raw content。
参数语义：country 主要配合 general；news/finance 下可能不符合预期。注意 Tavily 可能默认开启 auto_parameters，需要时显式传 --search-depth basic。
故障：401 查 Key，429 等限流；Research 长时间 pending 可加大 --max-wait-seconds。失败响应里的 request_id 便于向官方 support 说明问题。