> ## 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

> Extract clean readable content from public URLs.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/tavily-extract)

**Clean web page extraction.** Turn one or more public URLs into readable text with Tavily Extract through AIsa.

## Install

First, install the AIsa CLI if you have not already:

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

Then install the skill:

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

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Article extraction" icon="scissors">
    Pull readable article text from a public URL.
  </Card>

  <Card title="Document review" icon="file-lines">
    Extract source text before analysis.
  </Card>

  <Card title="Citation prep" icon="quote-left">
    Keep source content attached to summaries.
  </Card>

  <Card title="Research cleanup" icon="broom">
    Remove page chrome and keep useful content.
  </Card>
</CardGroup>

## Setup

This skill requires the `AISA_API_KEY` environment variable. When installed as a Claude plugin, the key is configured via the plugin's `userConfig`.

## Usage

Run the search client with the `extract` subcommand:

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

### Arguments

| Argument        | Required | Default | Description                                          |
| --------------- | -------- | ------- | ---------------------------------------------------- |
| `--urls` / `-u` | Yes      | —       | Comma-separated list of URLs to extract content from |

### Examples

```bash theme={null}
# Extract a single article
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-extract/scripts/search_client.py extract --urls "https://example.com/article"

# Extract multiple pages
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-extract/scripts/search_client.py extract --urls "https://example.com/page1,https://example.com/page2"
```

## Output

For each URL, the script prints:

* **URL** — The source URL
* **Content** — Clean extracted text (up to 3000 characters per page)

## When to Use

Use this skill when the user provides a URL and wants to read or analyze its content, or when you need to fetch the full text of an article found via search. This is the best tool for "read this page" or "summarize this URL" requests.

## Get started

1. Sign up at [aisa.one](https://aisa.one) (new accounts start with \$2 free credit).
2. Generate an API key from the console.
3. Set your key and install the skill:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install tavily-extract
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="Tavily Search" icon="magnifying-glass" href="/agent-skills/tavily-search">
    Search the web before extracting sources.
  </Card>

  <Card title="AIsa Tavily Search" icon="magnifying-glass-plus" href="/agent-skills/aisa-tavily">
    Combined search and extraction workflow.
  </Card>

  <Card title="Tavily Extract API" icon="code" href="/api-reference/search/post_tavily-extract">
    Endpoint reference for extraction.
  </Card>
</CardGroup>