tavily-tools

tavily-tools 为直接从开发环境与 Tavily AI 服务互动提供了强大的接口。它专为需要精确、上下文感知网页资料检索与处理的工程师、研究人员及数据分析师所设计。通过将复杂的 API 互动抽象化为统一的 Python CLI，它能将网页智能无缝整合至自动化工作流程中。无论是执行程序库文件的快速搜索、爬取复杂的网站结构，还是编排多步骤的深度研究调查，本工具都能为搜索深度、结果筛选与输出格式化提供必要的控制。

• 高级网页搜索，支持网域白名单、黑名单以及本地化国家过滤器。

• 网页内容提取功能，提供简洁的 Markdown 或纯文字输出，非常适合用于注入 LLM 上下文。

• 网站爬取与链接结构映射，具备可设定的深度、广度与页面限制，确保资料收集效率。

• 深度研究代理能力，执行多步骤操作以生成结构化且标注来源的调查报告。

• 通过 TAVILY_API_KEY 进行统一环境配置，并支持 1Password 自动注入以实现无缝的安全管理。

• 需要使用 python 与 uv 进行环境管理与脚本执行。

• 通过 search、extract、crawl、map 与 research 等指令，配合特定的标记 (如 --query、--urls、--url) 来确保正确的 API 使用方式。

• 针对高可靠性场景设计；指令会回传包含成功状态、原始结果或错误诊断的结构化 JSON 响应。

• 使用爬虫与映射功能时，建议监控频率限制并遵守网站的爬取规则，以避免过度负载。

• 输出格式可通过 CLI 标记 (例如 --format markdown) 进行自定义，以符合技术管线中的后续处理需求。