AI Agent 专属实时搜索引擎

基于 Tavily API 的实时网页搜索技能，专为 AI Agent 优化，提供结构化结果、AI 生成答案与相关性评分，用于获取训练截止后的最新信息。

基本信息

• 技能名称?Tavily Web Search
• 中文名称?AI Agent 专属实时搜索引擎
• 作者?moochmaniac
• 分类?专业技能
• 版本?1.0.0
• 标签?web-search, tavily, real-time-data, ai-agent, information-retrieval, api-integration, research-tool

使用方法

使用说明
核心用法
Tavily Search 技能通过调用 Tavily API 实现实时网络搜索，专为 AI Agent 工作流设计。基础用法为 python3 scripts/search.py "查询内容" ，支持 1-10 条结果控制（默认 5 条）。核心参数包括 --depth （basic/advanced 两档搜索深度）、 --answer （生成 AI 摘要答案）、 --images （获取相关图片 URL）及 --json （原始 JSON 输出）。API 密钥通过三级路径读取：OpenClaw 工作区 workspace/secrets/tavily_api_key 、相对路径 secrets/tavily_api_key 或环境变量 TAVILY_API_KEY 。
显著优点

1. 结构化输出 ：返回包含标题、URL、相关性评分（0-1）、内容片段的标准化结果，降低 Agent 解析成本
2. AI 原生设计 ：Tavily 专为 LLM 优化，相比传统搜索引擎（Google/Bing）返回更干净、无广告的内容块
3. 搜索深度可控 ：basic 模式响应快、消耗低，advanced 模式深度抓取适合综合研究
4. 集成友好 ：提供格式化文本与原始 JSON 两种输出，便于不同场景消费
5. 多模态支持 ：可选图片结果，扩展信息获取维度
   潜在缺点与局限性
   成本约束 ：advanced 深度及高数量结果会显著增加 API 调用成本
   内容截断 ：片段固定 300 字符限制，复杂议题需多次查询或阅读原文
   来源单一 ：依赖 Tavily 索引覆盖范围，小众或极新内容可能缺失
   无本地缓存 ：每次调用均产生网络请求与 API 费用，高频场景需成本规划
   答案质量波动 ： --answer 生成的摘要准确性受 Tavily 内部 LLM 能力制约
   适合人群
   需要突破训练数据时间限制的 AI Agent 开发者
   进行竞品分析、市场研究、新闻监控的研究人员
   构建 RAG 系统需实时检索增强的工程师
   需要快速事实核查与多源交叉验证的内容创作者
   常规风险
6. API 密钥泄露 ：密钥存储于本地文件路径，多用户环境需严格权限管理
7. 成本失控 ：advanced 模式与高频调用易触达用量上限，建议实施配额监控
8. 信息时效幻觉 ：搜索结果虽为实时，但 Tavily 索引本身存在抓取延迟（通常分钟级）
9. 版权与合规 ：抓取内容的使用需遵守目标网站 robots.txt 及服务条款