tavily-search

# Tavily Search - 智能搜索工具

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

## Features

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

## Setup

### 1. 获取API Key

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

### 2. 配置OpenClaw

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

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

## Usage

### 基础搜索

```bash
# 搜索最新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调用

```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新闻搜索
```bash
python3 scripts/search.py "OpenAI GPT-5 release" --days 7 --include-answer
```

### 学术研究
```bash
python3 scripts/search.py "transformer architecture survey" \
  --search-depth advanced --max-results 10
```

### 技术问题
```bash
python3 scripts/search.py "Docker compose networking tutorial" \
  --include-answer --lang zh
```

## Free Tier Limits

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

## Response Format

```json
{
  "quer...