tavily-search

name	tavily-search
description	使用Tavily API进行智能网络搜索。无需信用卡，每月1000次免费查询。支持AI增强的搜索结果和深度研究模式。Use when: 需要高质量搜索结果、学术研究、或不想绑定信用卡的场景。
homepage	https://tavily.com

Tavily Search - 智能搜索工具

基于Tavily API的网络搜索skill，提供高质量的AI增强搜索结果。

Features

• ✅ 无需信用卡 - 每月1000次免费查询
• 🤖 AI增强 - 自动提取关键信息，生成摘要
• 🔬 深度研究模式 - 多源综合分析
• 📚 学术友好 - 适合研究和信息收集
• 🌐 多语言支持 - 中英文搜索优化

Setup

1. 获取API Key

1. 访问 https://tavily.com/
2. 注册账号（邮箱即可，无需绑卡）
3. 在Dashboard复制API Key

2. 配置OpenClaw

# 设置环境变量
export TAVILY_API_KEY="tvly-..."

# 或者写入配置文件
echo 'TAVILY_API_KEY=tvly-...' >> ~/.openclaw/.env

Usage

基础搜索

# 搜索最新AI新闻
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "AI artificial intelligence news today"

# 中文搜索
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "人工智能最新进展" --lang zh

Python调用

import subprocess
import json

result = subprocess.run(
    ['python3', '~/.openclaw/skills/tavily-search/scripts/search.py', 
     '你的搜索词', '--json'],
    capture_output=True, text=True
)
data = json.loads(result.stdout)

Parameters

参数	说明	默认值
query	搜索关键词	必填
--max-results	返回结果数量 (1-20)	5
--search-depth	搜索深度 (basic/advanced)	basic
--include-answer	包含AI生成的答案	True
--include-images	包含相关图片	False
--days	时间范围（天）	无限制
--lang	语言偏好 (zh/en)	auto
--json	JSON格式输出	False

Examples

AI新闻搜索

python3 scripts/search.py "OpenAI GPT-5 release" --days 7 --include-answer

学术研究

python3 scripts/search.py "transformer architecture survey" \
  --search-depth advanced --max-results 10

技术问题

python3 scripts/search.py "Docker compose networking tutorial" \
  --include-answer --lang zh

Free Tier Limits

• 每月1000次API调用
• 每次最多20个结果
• 基础搜索深度
• 学生可申请更多额度

Response Format

{
  "query": "搜索词",
  "answer": "AI生成的综合答案（可选）",
  "results": [
    {
      "title": "标题",
      "url": "链接",
      "content": "内容摘要",
      "score": 0.95,
      "published_date": "2024-03-01"
    }
  ],
  "images": [...]
}

Notes

• 首次使用需要先配置TAVILY_API_KEY
• 建议将API key添加到~/.openclaw/.env
• 超过免费额度后会返回错误提示