← Back to Skills Marketplace
bibaofeng

Tavily Search

by bibaofeng · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
47
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tavily-search-aisa-api
Description
Advanced web search via Tavily through AIsa API. Supports search depth, topic filtering (general/news/finance), time ranges, domain inclusion/exclusion, and...
README (SKILL.md)

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 "\x3Csearch 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

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

Usage Guidance
This skill appears safe for its stated purpose if you are comfortable using AIsa/Tavily as an external search provider. Before installing, make sure you trust the provider with your search queries, protect the AISA_API_KEY, and avoid sending sensitive private information unless intended.
Capability Analysis
Type: OpenClaw Skill Name: tavily-search-aisa-api Version: 1.0.0 The skill is a legitimate search tool that interfaces with the AIsa API (api.aisa.one). The Python script `scripts/search_client.py` uses standard libraries to perform web searches and content extraction as described in `SKILL.md`, with no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The stated Tavily search purpose is coherent, but the bundled client also documents broader AIsa search modes such as web, scholar, smart, extract, sonar, and verity.
Instruction Scope
The skill provides normal user-invoked CLI usage for search and does not include prompt overrides, goal hijacking, or instructions to run automatically.
Install Mechanism
No install script is specified; the skill requires only python3 and the provided script.
Credentials
The AISA_API_KEY credential and outbound calls to api.aisa.one are expected for a hosted search API, but users should understand that their queries are sent to that provider and may consume account credits.
Persistence & Privilege
The provided artifacts show no persistence, background execution, privileged local changes, or file writes.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tavily-search-aisa-api
  3. After installation, invoke the skill by name or use /tavily-search-aisa-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Tavily Search skill via AIsa API: - Provides advanced web search with options for search depth, topic filtering (general, news, finance), time range, and domain filters. - Supports LLM-generated answer summaries alongside raw results. - Requires `AISA_API_KEY` environment variable for setup. - User-invocable with a command-line client supporting a wide range of query options. - Outputs structured search results including title, URL, date, excerpt, and optional answer.
Metadata
Slug tavily-search-aisa-api
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Tavily Search?

Advanced web search via Tavily through AIsa API. Supports search depth, topic filtering (general/news/finance), time ranges, domain inclusion/exclusion, and... It is an AI Agent Skill for Claude Code / OpenClaw, with 47 downloads so far.

How do I install Tavily Search?

Run "/install tavily-search-aisa-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Tavily Search free?

Yes, Tavily Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Tavily Search support?

Tavily Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Tavily Search?

It is built and maintained by bibaofeng (@bibaofeng); the current version is v1.0.0.

💬 Comments