> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AIsa Tavily Extract

> 从公开 URL 提取干净、可读的内容。

[在 GitHub 上查看 ->](https://github.com/AIsa-team/agent-skills/tree/main/tavily-extract)

**干净的网页内容提取。** 通过 AIsa 使用 Tavily Extract，将一个或多个公开 URL 转成可读文本。

## 安装

如果还没有安装 AIsa CLI，请先安装：

```bash theme={null}
npm install -g @aisa-one/cli
```

然后安装该技能：

```bash theme={null}
aisa skills install tavily-extract
```

## Agent 可以用它做什么？

<CardGroup cols={2}>
  <Card title="文章提取" icon="scissors">
    从公开 URL 拉取可读文章文本。
  </Card>

  <Card title="文档复核" icon="file-lines">
    在分析前提取源文本。
  </Card>

  <Card title="引用准备" icon="quote-left">
    让摘要保留对应的来源内容。
  </Card>

  <Card title="研究清理" icon="broom">
    去掉页面外壳，只保留有用内容。
  </Card>
</CardGroup>

## 设置

该技能需要 `AISA_API_KEY` 环境变量。作为 Claude 插件安装时，key 会通过插件的 `userConfig` 配置。

## 用法

用 `extract` 子命令运行搜索客户端：

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-extract/scripts/search_client.py extract --urls "<comma-separated URLs>"
```

### 参数

| Argument        | Required | Default | Description      |
| --------------- | -------- | ------- | ---------------- |
| `--urls` / `-u` | Yes      | —       | 要提取内容的 URL，以逗号分隔 |

### 示例

```bash theme={null}
# 提取单篇文章
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-extract/scripts/search_client.py extract --urls "https://example.com/article"

# 提取多个页面
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-extract/scripts/search_client.py extract --urls "https://example.com/page1,https://example.com/page2"
```

## 输出

对每个 URL，脚本会打印：

* **URL** — 来源 URL
* **Content** — 干净提取文本（每页最多 3000 字符）

## 何时使用

当用户提供 URL 并希望阅读或分析其内容，或当你需要获取搜索结果中某篇文章的全文时使用该技能。它最适合“读这个页面”或“总结这个 URL”类请求。

## 开始使用

1. 在 [aisa.one](https://aisa.one) 注册（新账户有 \$2 免费额度）。
2. 从控制台生成 API key。
3. 设置 key 并安装技能：
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install tavily-extract
   ```
4. 启动新的 Agent 会话，让运行时加载更新后的技能说明。

## 相关

<CardGroup cols={3}>
  <Card title="Tavily Search" icon="magnifying-glass" href="/zh/agent-skills/tavily-search">
    提取来源前先搜索网页。
  </Card>

  <Card title="AIsa Tavily Search" icon="magnifying-glass-plus" href="/agent-skills/aisa-tavily">
    组合搜索与提取工作流。
  </Card>

  <Card title="Tavily Extract API" icon="code" href="/api-reference/search/post_tavily-extract">
    提取端点参考。
  </Card>
</CardGroup>
