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

# Tavily Search

> Run configurable web searches with Tavily through AIsa.

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

**Flexible web search through Tavily.** Run focused web, news, and domain searches with AIsa-managed access.

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

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Current web search" icon="globe">
    Find fresh web results for a query.
  </Card>

  <Card title="Domain filters" icon="filter">
    Include or exclude domains for focused retrieval.
  </Card>

  <Card title="Time windows" icon="calendar-days">
    Search within relevant recency ranges.
  </Card>

  <Card title="Topic filters" icon="tags">
    Narrow search to the right kind of source.
  </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 `tavily` subcommand:

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "<search query>" [options]
```

### Arguments

| Argument           | Required | Default | Description                                             |
| ------------------ | -------- | ------- | ------------------------------------------------------- |
| `--query` / `-q`   | Yes      | —       | Search query                                            |
| `--count` / `-c`   | No       | 5       | Maximum results (1–20)                                  |
| `--depth`          | No       | basic   | Search depth: `basic`, `advanced`, `fast`, `ultra-fast` |
| `--topic`          | No       | —       | Topic filter: `general`, `news`, `finance`              |
| `--time-range`     | No       | —       | Time range filter                                       |
| `--include-answer` | No       | false   | Include an LLM-generated answer summary                 |

### Examples

```bash theme={null}
# Basic search
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "OpenAI latest announcements" --count 10

# Advanced news search with answer
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "AI regulation 2026" --depth advanced --topic news --include-answer

# Finance-focused search
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "NVIDIA earnings Q1 2026" --topic finance --include-answer
```

## Output

The script prints structured results including:

* **Title** — Page title
* **URL** — Direct link
* **Date** — Publication date (when available)
* **Content** — Relevant excerpt
* **Answer** — LLM-generated summary (when `--include-answer` is used)

## When to Use

Use this skill when the user needs advanced search with specific filtering requirements: news-only results, finance-focused results, time-bounded searches, or when they want an AI-generated answer alongside raw results. This is the most feature-rich search tool in the plugin.

## 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-search
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="Tavily Search API" icon="code" href="/api-reference/search/post_tavily-search">
    Endpoint reference for Tavily search.
  </Card>

  <Card title="AIsa Tavily Extract" icon="scissors" href="/agent-skills/tavily-extract">
    Extract full content from selected URLs.
  </Card>

  <Card title="AIsa Web Search" icon="globe" href="/agent-skills/web-search">
    General web search with structured results.
  </Card>
</CardGroup>