搜索技能

搜索网络并获取针对大型语言模型消费优化的相关结果。

身份验证

该脚本通过 Tavily 模型上下文协议服务器使用 OAuth。无需手动设置 – 首次运行时，它将：

1. 检查 ~/.mcp-auth/ 中是否存在现有令牌
2. 如果未找到，将自动打开你的浏览器进行 OAuth 身份验证

注意： 你必须有一个现有的 Tavily 账户。OAuth 流程仅支持登录——无法通过此流程创建账户。如果你没有账户，请先在 tavily.com 注册。

替代方案：应用程序编程接口密钥

如果你更愿意使用应用程序编程接口密钥，可以在 https://tavily.com 获取一个，并将其添加到 ~/.claude/settings.json：

{
  "env": {
    "TAVILY_API_KEY": "tvly-你的-api-密钥"
  }
}

快速开始

使用脚本

./scripts/search.sh '<json>'

示例：

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

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

# 带过滤条件的高级搜索
./scripts/search.sh '{"query": "AI 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"]
  }'

应用程序编程接口参考

端点

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

请求头

请求体

响应格式

{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "页面标题",
      "url": "https://example.com/page",
      "content": "提取的文本片段...",
      "score": 0.85
    }
  ],
  "response_time": 1.2
}

搜索深度

何时使用每种深度：

• ultra-fast：实时聊天、自动补全
• fast：需要片段但延迟重要
• basic：通用目的，均衡
• advanced：精度重要（默认推荐）

示例

按域名过滤的搜索

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
  }'

提示

• 保持查询在 400 字符以内 – 把它看作搜索查询，而不是提示词
• 将复杂查询分解为子查询 – 比一个庞大查询效果更好
• 使用 include_domains 专注于可信来源
• 使用 time_range 获取最新信息
• 按 score（0-1）过滤 以获得相关性最高的结果