tavily-search

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

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

nametavily-search

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

homepagehttps://tavily.com

metadata[object Object]

Tavily Search - 智能搜索工具

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

Features

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

Setup

1. 获取API Key

访问 https://tavily.com/
注册账号（邮箱即可，无需绑卡）
在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
超过免费额度后会返回错误提示