搜索技能

在 Web 上执行搜索，并返回专为大语言模型（LLM）消费而优化的相关结果。

前提条件

需要 Tavily API 密钥 —— 请前往 https://tavily.com 获取您的密钥

将其添加到 ~/.claude/settings.json 中：

{
  "env": {
    "TAVILY_API_KEY": "tvly-your-api-key-here"
  }
}

快速开始

使用脚本

./scripts/search.sh ''

示例：

# 基础搜索
./scripts/search.sh '{"query": "python async patterns"}'

# 带选项的搜索
./scripts/search.sh '{"query": "React hooks tutorial", "max_results": 10}'

# 带过滤器的高级搜索
./scripts/search.sh '{"query": "AI news", "topic": "news", "time_range": "week", "max_results": 10}'

# 按域名过滤的搜索
./scripts/search.sh '{"query": "machine learning", "include_domains": ["arxiv.org", "github.com"], "search_depth": "advanced"}'

基础搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "latest developments in quantum computing",
    "max_results": 5
  }'

高级搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "machine learning best practices",
    "max_results": 10,
    "search_depth": "advanced",
    "include_domains": ["arxiv.org", "github.com"],
    "chunks_per_source": 3
  }'

API 参考文档

接口地址

POST https://api.tavily.com/search

请求头（Headers）

请求体（Request Body）

响应格式

{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com/page",
      "content": "Extracted text snippet...",
      "score": 0.85
    }
  ],
  "response_time": 1.2
}

搜索深度说明

各搜索深度适用场景：

• ultra-fast：实时对话、自动补全等对延迟极度敏感的场景
• fast：需要文本块（Chunks），但延迟仍为关键考量因素
• basic：通用搜索场景，兼顾速度与质量的平衡选择
• advanced：对结果精度要求极高（推荐作为默认选项）

示例

新闻搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "AI news today",
    "topic": "news",
    "time_range": "day",
    "max_results": 10
  }'

按域名过滤的搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "Python async best practices",
    "include_domains": ["docs.python.org", "realpython.com", "github.com"],
    "search_depth": "advanced"
  }'

包含全文内容的搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "React hooks tutorial",
    "max_results": 3,
    "include_raw_content": true
  }'

金融类搜索

curl --request POST 
  --url https://api.tavily.com/search 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "query": "AAPL earnings Q4 2024",
    "topic": "finance",
    "max_results": 10
  }'

使用提示

• 搜索查询语句长度建议控制在 400 字符以内 —— 应视作传统搜索引擎的查询词，而非 LLM 提示词
• 将复杂查询拆分为多个子查询 —— 相比单个巨型查询，分步搜索通常能获得更优结果
• 善用 include_domains 限定可信信源范围
• 善用 time_range 确保获取最新信息
• 根据响应中的 score 字段（取值范围 0–1）进行筛选 —— 保留高相关性结果