用途：该技能提供基于 curl 的接口，调用 Tavily REST API，用于网页搜索、内容提取、站点映射、站点爬取和可选的研究（多步深入调查）。适用于任务需要实时网页信息、站点提取、映射或爬取，以及需要结构化搜索结果或 LLM 友好输出（摘要、内容分块、来源、引用）的场景。
认证与基础信息：需在环境中设置 TAVILY_API_KEY，缺失时应先向用户索取。基础 URL 为 https://api.tavily.com，鉴权使用 Authorization: Bearer $TAVILY_API_KEY，Content-Type: application/json；如需项目归属可加 X-Project-ID。
主要端点：
- 搜索 POST /search：支持 query、search_depth（basic/advanced/fast/ultra-fast）、chunks_per_source、max_results（0-20）、topic（general/news/finance）、time_range、start_date/end_date、include_answer、include_raw_content、include_images、include_domains/exclude_domains、country、auto_parameters 等；返回 answer、results[]（title、url、content、score 等）、response_time、usage、request_id。
- 提取 POST /extract：对指定 URL 提取内容，支持 urls、query（用于重排）、chunks_per_source、extract_depth、format（markdown/text）、timeout、include_usage；返回 results[]、failed_results[] 等。
- 映射 POST /map：生成站点地图（仅 URL 发现），支持 url、instructions、max_depth、max_breadth、limit、select_paths/exclude_paths 等；返回 base_url、results[] URL 列表等。
- 爬取 POST /crawl：站点遍历并提取内容，参数与 map 类似，另含 extract_depth、format、include_images 等。
- 可选研究：POST /research 创建任务，GET /research/{request_id} 查询状态和报告，支持 stream: true 的 SSE 流式事件。
使用建议与限制：搜索、提取、映射、爬取为主要端点；默认采用保守参数（search_depth: basic、max_results: 5），需要更深召回再调高。遇 401/403 应检查 API 密钥；超时可降低 max_depth/limit 或使用 basic 搜索深度；响应过大可减少 max_results 或 chunks_per_source。资料未提供具体定价、速率限制与平台支持范围。