Agent Skills › linuxhsj/openclaw-zero-token › tavily

tavily

GitHub

提供 Tavily 网络搜索、内容提取与研究工具的使用指南，涵盖快速搜索、高级筛选及 URL 内容抓取场景。

extensions/tavily/skills/tavily/SKILL.md linuxhsj/openclaw-zero-token

Trigger Scenarios

需要实时或特定领域的网络搜索结果需要从指定 URL 提取页面内容

Install

npx skills add linuxhsj/openclaw-zero-token --skill tavily -g -y

More Options

Non-standard path

npx skills add https://github.com/linuxhsj/openclaw-zero-token/tree/main/extensions/tavily/skills/tavily -g -y

Use without installing

npx skills use linuxhsj/openclaw-zero-token@tavily

指定 Agent (Claude Code)

npx skills add linuxhsj/openclaw-zero-token --skill tavily -a claude-code -g -y

安装 repo 全部 skill

npx skills add linuxhsj/openclaw-zero-token --all -g -y

预览 repo 内 skill

npx skills add linuxhsj/openclaw-zero-token --list

SKILL.md

Frontmatter

{
    "name": "tavily",
    "metadata": {
        "openclaw": {
            "emoji": "🔍",
            "requires": {
                "config": [
                    "plugins.entries.tavily.enabled"
                ]
            }
        }
    },
    "description": "Tavily web search, content extraction, and research tools."
}

Tavily Tools

When to use which tool

Need	Tool	When
Quick web search	`web_search`	Basic queries, no special options needed
Search with advanced options	`tavily_search`	Need depth, topic, domain filters, time ranges, or AI answers
Extract content from URLs	`tavily_extract`	Have specific URLs, need their content

web_search

Tavily powers this automatically when selected as the search provider. Use for straightforward queries where you don't need Tavily-specific options.

Parameter	Description
`query`	Search query string
`count`	Number of results (1-20)

tavily_search

Use when you need fine-grained control over search behavior.

Parameter	Description
`query`	Search query string (keep under 400 characters)
`search_depth`	`basic` (default, balanced) or `advanced` (highest relevance, slower)
`topic`	`general` (default), `news` (real-time updates), or `finance`
`max_results`	Number of results, 1-20 (default: 5)
`include_answer`	Include an AI-generated answer summary (default: false)
`time_range`	Filter by recency: `day`, `week`, `month`, or `year`
`include_domains`	Array of domains to restrict results to
`exclude_domains`	Array of domains to exclude from results

Search depth

Depth	Speed	Relevance	Best for
`basic`	Faster	High	General-purpose queries (default)
`advanced`	Slower	Highest	Precision, specific facts, detailed research

Tips

Keep queries under 400 characters — think search query, not prompt.
Break complex queries into sub-queries for better results.
Use include_domains to focus on trusted sources.
Use time_range for recent information (news, current events).
Use include_answer when you need a quick synthesized answer.

tavily_extract

Use when you have specific URLs and need their content. Handles JavaScript-rendered pages and returns clean markdown. Supports query-focused chunking for targeted extraction.

Parameter	Description
`urls`	Array of URLs to extract (1-20 per request)
`query`	Rerank extracted chunks by relevance to this query
`extract_depth`	`basic` (default, fast) or `advanced` (for JS-heavy pages, tables)
`chunks_per_source`	Chunks per URL, 1-5 (requires `query`)
`include_images`	Include image URLs in results (default: false)

Extract depth

Depth	When to use
`basic`	Simple pages — try this first
`advanced`	JS-rendered SPAs, dynamic content, tables, embedded content

Tips

Max 20 URLs per request — batch larger lists into multiple calls.
Use query + chunks_per_source to get only relevant content instead of full pages.
Try basic first, fall back to advanced if content is missing or incomplete.
If tavily_search results already contain the snippets you need, skip the extract step.

Choosing the right workflow

Follow this escalation pattern — start simple, escalate only when needed:

web_search — Quick lookup, no special options needed.
tavily_search — Need depth control, topic filtering, domain filters, time ranges, or AI answers.
tavily_extract — Have specific URLs, need their full content or targeted chunks.

Combine search + extract when you need to find pages first, then get their full content.