Tavily Search

这是基于Tavily的高级搜索工具，通过AIsa API实现。支持自定义搜索深度、主题分类（通用/新闻/财经）、时间范围筛选等，还可选生成AI总结回答。适用于网页搜索、资料调研、资源提取等场景。以命令行传入查询及参数，输出含标题、URL、摘要、发布日期及可选AI回答的结构化结果。

bibaofeng

热度 29.08

最近更新 2026-05-19 05:03:43

分类：搜索依赖：代码执行 / 第三方 API / 内部调用大模型应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tavily-search-aisa-api

Metadata

name: 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 LLM-generated answers. Use when: the user needs web search, research, source discovery, or content extraction.
author: AIsa
version: 1.0.1
license: Apache-2.0
homepage: https://aisa.one
source: https://github.com/baofeng-tech/agent-skills-io/tree/main/targetSkills/tavily-search
user-invocable: true
primaryEnv: AISA_API_KEY
requires: {"bins":["python3"],"env":["AISA_API_KEY"]}
metadata: {"aisa":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]},"openclaw":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

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

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