Skip to main content

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.

View on GitHub -> Flexible web search through Tavily. Run focused web, news, and domain searches with AIsa-managed access.

​
Install

aisa skills install tavily-search

​
What can agents do with it?

Current web search

Find fresh web results for a query.

Domain filters

Include or exclude domains for focused retrieval.

Time windows

Search within relevant recency ranges.

Topic filters

Narrow search to the right kind of source.

​
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: 
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "<search query>" [options]

​
Arguments

ArgumentRequiredDefaultDescription
--query / -qYes—Search query
--count / -cNo5Maximum results (1–20)
--depthNobasicSearch depth: basic, advanced, fast, ultra-fast
--topicNo—Topic filter: general, news, finance
--time-rangeNo—Time range filter
--include-answerNofalseInclude an LLM-generated answer summary

​
Examples

# 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 (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. Set your key and install the skill: 
    export AISA_API_KEY="your-key"
aisa skills install tavily-search
  4. Start a new agent session so the runtime loads the updated skill instructions.

Tavily Search API

Endpoint reference for Tavily search.

AIsa Tavily Extract

Extract full content from selected URLs.

AIsa Web Search

General web search with structured results.