Agent skill

tavily

Tavily web search, content extraction, and research tools.

View SKILL.md on GitHub Repository
Stars 355,710
Forks 72,004

Install this agent skill to your Project

npx add-skill https://github.com/openclaw/openclaw/tree/main/extensions/tavily/skills/tavily

Metadata

Additional technical details for this skill

openclaw 
{
    "emoji": "\ud83d\udd0d",
    "requires": {
        "config": [
            "plugins.entries.tavily.enabled"
        ]
    }
}

SKILL.md

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:

  1. web_search — Quick lookup, no special options needed.
  2. tavily_search — Need depth control, topic filtering, domain filters, time ranges, or AI answers.
  3. 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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

openclaw/openclaw

openclaw-test-heap-leaks

Investigate `pnpm test` memory growth, Vitest worker OOMs, and suspicious RSS increases in OpenClaw using the `scripts/test-parallel.mjs` heap snapshot tooling. Use when Codex needs to reproduce test-lane memory growth, collect repeated `.heapsnapshot` files, compare snapshots from the same worker PID, distinguish transformed-module retention from real data leaks, and fix or reduce the impact by patching cleanup logic or isolating hotspot tests.

355,710 72,004
Explore
openclaw/openclaw

parallels-discord-roundtrip

Run the macOS Parallels smoke harness with Discord end-to-end roundtrip verification, including guest send, host verification, host reply, and guest readback.

355,710 72,004
Explore
openclaw/openclaw

security-triage

Triage GitHub security advisories for OpenClaw with high-confidence close/keep decisions, exact tag and commit verification, trust-model checks, optional hardening notes, and a final reply ready to post and copy to clipboard.

355,710 72,004
Explore
openclaw/openclaw

openclaw-release-maintainer

Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.

355,710 72,004
Explore
openclaw/openclaw

openclaw-ghsa-maintainer

Maintainer workflow for OpenClaw GitHub Security Advisories (GHSA). Use when Codex needs to inspect, patch, validate, or publish a repo advisory, verify private-fork state, prepare advisory Markdown or JSON payloads safely, handle GHSA API-specific publish constraints, or confirm advisory publish success.

355,710 72,004
Explore
openclaw/openclaw

openclaw-pr-maintainer

Maintainer workflow for reviewing, triaging, preparing, closing, or landing OpenClaw pull requests and related issues. Use when Codex needs to validate bug-fix claims, search for related issues or PRs, apply or recommend close/reason labels, prepare GitHub comments safely, check review-thread follow-up, or perform maintainer-style PR decision making before merge or closure.

355,710 72,004
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results