Tavily Search Skill
使用 Tavily 的 LLM 优化 API 进行网络搜索、深度研究和内容提取。
配置
API Key 保存在 .env 文件中(与 SKILL.md 同目录):
TAVILY_API_KEY=tvly-your-key-here
获取免费 API Key: https://tavily.com
三个功能
1. Search - 网络搜索
快速搜索,返回相关结果。
python scripts/tavily_client.py "搜索内容"
参数:
| 参数 | 简写 | 默认 | 说明 |
|---|---|---|---|
--max-results |
-n |
10 | 结果数量 (1-20) |
--search-depth |
-d |
advanced | 搜索深度: ultra-fast, fast, basic, advanced |
--time-range |
-t |
null | 时间: day, week, month, year |
--json |
-j |
false | 输出 JSON |
2. Research - 深度研究
对主题进行深入研究,返回完整答案和引用来源。(耗时 30-120 秒)
python scripts/tavily_research.py "量子计算发展趋势"
参数:
| 参数 | 简写 | 默认 | 说明 |
|---|---|---|---|
--model |
-m |
mini | 模型: mini, pro, auto |
--max-results |
-n |
null | 最大来源数 |
--output |
-o |
null | 保存到文件 |
--json |
-j |
false | 输出 JSON |
3. Extract - URL 内容提取
从指定 URL 提取干净的内容。
python scripts/tavily_extract.py "https://example.com"
参数:
| 参数 | 简写 | 默认 | 说明 |
|---|---|---|---|
--extract-depth |
-d |
basic | 深度: basic, deep |
--output |
-o |
null | 保存到文件 |
--json |
-j |
false | 输出 JSON |
示例
# 搜索
python scripts/tavily_client.py "AI 新闻" --max-results 5 --time-range week
# 研究(需等待)
python scripts/tavily_research.py "Python vs JavaScript" --model pro --output report.md
# 提取
python scripts/tavily_extract.py "https://github.com" --output content.md
