提取技能（Extract Skill）

从指定 URL 提取干净、结构化的内容。适用于您已明确知道需提取内容的目标页面的场景。

前提条件

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

将其添加至 ~/.claude/settings.json 文件中：

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

快速开始

使用脚本

./scripts/extract.sh ''

示例：

# 单个 URL
./scripts/extract.sh '{"urls": ["https://example.com/article"]}'

# 多个 URL
./scripts/extract.sh '{"urls": ["https://example.com/page1", "https://example.com/page2"]}'

# 指定查询焦点与分块数量
./scripts/extract.sh '{"urls": ["https://example.com/docs"], "query": "authentication API", "chunks_per_source": 3}'

# 针对 JS 渲染页面的高级提取
./scripts/extract.sh '{"urls": ["https://app.example.com"], "extract_depth": "advanced", "timeout": 60}'

基础提取

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": ["https://example.com/article"]
  }'

带查询焦点的多 URL 提取

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": [
      "https://example.com/ml-healthcare",
      "https://example.com/ai-diagnostics"
    ],
    "query": "AI diagnostic tools accuracy",
    "chunks_per_source": 3
  }'

API 参考文档

端点（Endpoint）

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

请求头（Headers）

请求体（Request Body）

响应格式（Response Format）

{
  "results": [
    {
      "url": "https://example.com/article",
      "raw_content": "# Article TitlennContent..."
    }
  ],
  "failed_results": [],
  "response_time": 2.3
}

提取深度（Extract Depth）

示例

单 URL 提取

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": ["https://docs.python.org/3/tutorial/classes.html"],
    "extract_depth": "basic"
  }'

带查询目标的提取

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": [
      "https://example.com/react-hooks",
      "https://example.com/react-state"
    ],
    "query": "useState and useEffect patterns",
    "chunks_per_source": 2
  }'

JavaScript 密集型页面

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": ["https://app.example.com/dashboard"],
    "extract_depth": "advanced",
    "timeout": 60
  }'

批量提取

curl --request POST 
  --url https://api.tavily.com/extract 
  --header "Authorization: Bearer $TAVILY_API_KEY" 
  --header 'Content-Type: application/json' 
  --data '{
    "urls": [
      "https://example.com/page1",
      "https://example.com/page2",
      "https://example.com/page3",
      "https://example.com/page4",
      "https://example.com/page5"
    ],
    "extract_depth": "basic"
  }'

使用提示（Tips）

• 单次请求最多支持 20 个 URL —— 超出请分批处理
• 结合使用 query 和 chunks_per_source，以仅获取与查询高度相关的内容分块
• 优先尝试 basic 模式，若发现关键内容缺失，再回退至 advanced 模式
• 为加载缓慢的页面设置更长的 timeout（最长支持 60 秒）
• 检查响应中的 failed_results 字段，定位无法成功提取的 URL