| name | tavily-search |
| description | Advanced web search via Tavily through AIsa API. Supports search depth, topic filtering (general/news/finance), time ranges, domain inclusion/exclusion, and LLM-generated answers. Use when: the user needs web search, research, source discovery, or content extraction. |
| compatibility | Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one. |
| metadata | {"aisa":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":"Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one."}} |
AIsa Tavily Search
Advanced web search powered by Tavily through the AIsa API. Offers fine-grained control over search depth, topic categories, time ranges, domain filtering, and optional LLM-generated answer summaries.
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
| 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
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "OpenAI latest announcements" --count 10
python3 ${CLAUDE_PLUGIN_ROOT}/skills/tavily-search/scripts/search_client.py tavily --query "AI regulation 2026" --depth advanced --topic news --include-answer
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.
