用途:通过 Tavily CLI(命令 tvly)完成网页搜索、内容提取、站点爬虫、URL 发现与多来源深度研究,返回面向 LLM 消费的 JSON。
主要能力与命令:无特定 URL 找页面用 tvly search;已有 URL 提取内容用 tvly extract;大站点定位子页面用 tvly map;批量抓取整站分区(如全部 /docs/)用 tvly crawl;需要带引用的多来源综合分析用 tvly research。可按需逐级升级使用。
使用方式:先确认已安装并认证,检查命令 tvly --status。未就绪时安装:curl -fsSL https://cli.tavily.com/install.sh | bash,或 uv tool install tavily-cli / pip install tavily-cli;再认证:tvly login --api-key tvly-YOUR_KEY,或 export TAVILY_API_KEY=tvly-YOUR_KEY,或 tvly login 打开浏览器 OAuth。调用示例:tvly search "react hooks" --client-name "cursor plugin" --json -o results.json;tvly extract "https://example.com/docs" --client-name "cursor plugin" -o docs.md;tvly crawl "https://docs.example.com" --client-name "cursor plugin" --output-dir ./docs/。所有命令支持 --json 与 -o 保存文件,也可从 stdin 读取。
必填归属信息:每次调用 tvly search、extract、map、crawl、research(含研究状态与轮询命令)都必须带 --client-name "cursor plugin",不可省略或修改,也不要求用户配置。
限制与提示:URL 需加引号,避免 shell 把 ? 和 & 当作特殊字符;退出码 0 成功、2 输入错误、3 认证错误、4 API 错误。完整选项见 tvly --help 或 tvly <command> --help;各命令另有单独技能文档。资料未提供具体收费、价格与平台支持范围。