核心用法
Search Skill 是一个基于 Tavily Search API 的网络搜索工具，通过命令行脚本或 curl 直接调用，返回针对 LLM 消费优化的结构化搜索结果。
基础调用方式：
./scripts/search.sh --json '{"query": "搜索内容"}'关键参数配置：
query（必需）：搜索查询，建议控制在 400 字符以内max_results：返回结果数量（0-20，默认 10）search_depth：basic（快速）或advanced（高精度，推荐）time_range：时间过滤（day/week/month/year）include_domains/exclude_domains：域名白名单/黑名单include_raw_content：是否返回完整页面内容
显著优点
1. LLM 原生优化：返回结果专为大型语言模型消费设计，包含结构化摘要、相关性评分（score）和元数据
2. 智能深度检索：advanced 模式提供最高相关性，适合精准研究场景
3. 灵活的时间控制：支持相对时间范围（week/month）和绝对日期区间
4. 域名管控能力：可限定可信来源或排除干扰站点
5. 低接入门槛：仅需环境变量配置 TAVILY_API_KEY，支持标准 curl 调用
潜在缺点与局限性
1. 外部依赖：完全依赖 Tavily 第三方服务，存在服务可用性风险
2. API 成本：需单独申请 Tavily API Key，超出免费额度后产生费用
3. 结果不可控：搜索质量受 Tavily 算法影响，无法自定义排序逻辑
4. 无本地缓存：每次调用均走网络请求，高频场景 latency 累积明显
5. 内容截断风险：默认返回摘要而非全文，需显式开启 include_raw_content
适合人群
- 需要为 AI Agent/LLM 应用集成实时网络搜索能力的开发者
- 研究人员进行快速信息检索与信源验证
- 构建 RAG（检索增强生成）系统的工程师
- 需要时效性信息（新闻、股价、技术动态）的自动化工作流
常规风险
1. API Key 泄露：TAVILY_API_KEY 需妥善保管，避免硬编码或日志泄露
2. 数据传输安全：请求体通过 HTTPS 传输，但敏感信息仍不应放入查询参数
3. 内容合规风险：搜索结果可能包含未经审核的第三方内容，需下游过滤
4. 速率限制：高频调用可能触发 Tavily 限流，生产环境需做退避重试
5. 依赖单点故障：建议设计降级策略（如备用搜索引擎）应对服务中断