Skillppx logo

Search

通过 Tavily API 实现高效网页搜索，获取带摘要的精准结果。

已扫描
适合谁
研究人员、内容创作者
不适合谁
无网络环境用户、无法获取 API 密钥者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @barneyjm/search-2
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Search Skill

在网页上进行搜索并获取针对大语言模型（LLM）优化的相关结果。

前置条件

需要 Tavily API 密钥 - 请访问 https://tavily.com 获取您的密钥

将密钥添加到 ~/.claude/settings.json 文件中：

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

快速开始

使用脚本

./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", "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

请求头

请求头值
AuthorizationBearer <TAVILY_API_KEY>
Content-Typeapplication/json

请求体字段

字段类型默认值说明
querystring必填搜索关键词（建议不超过 400 个字符）
max_resultsinteger5最多返回结果数量（0-20）
search_depthstring"basic"可选值：ultra-fast、fast、basic、advanced
topicstring"general"可选值：general、news、finance
chunks_per_sourceinteger3每个来源返回的文本块数量（仅适用于 advanced 或 fast 模式）
time_rangestringnull时间范围：day、week、month、year
include_domainsarray[]限定包含的域名列表（最多 300 个）
exclude_domainsarray[]排除的域名列表（最多 150 个）
include_answerbooleanfalse是否包含 AI 生成的答案
include_raw_contentbooleanfalse是否包含完整页面内容
include_imagesbooleanfalse是否包含图片结果

响应格式

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

搜索深度说明

深度延迟相关性内容类型
ultra-fast最低较低NLP 摘要
fast低良好文本块
basic中等高NLP 摘要
advanced较高最高文本块

各深度适用场景：

  • 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": "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 字符以内 —— 请以搜索关键词形式思考，而非提示词
  • 复杂查询拆分为多个子查询 —— 比单一长查询获得更优结果
  • **使用 include_domains** 来聚焦可信来源
  • **使用 time_range** 获取最新信息
  • **根据 score（0-1）筛选**，获取相关性最高的结果
B
@barneyjm

已收录 1 个 Skill

相关推荐