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) 進行自訂，以符合技術管線中的後續處理需求。