tavily-search

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.

SKILL.md

Quality

Evals

Security

Tavily Search

Search the web and get relevant results optimized for LLM consumption.

Authentication

Get your API key at https://tavily.com and add to your OpenClaw config:

{
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}

Or set the environment variable:

export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"

Quick Start

Using the Script

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news

Examples

# Basic search
node {baseDir}/scripts/search.mjs "python async patterns"

# With more results
node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10

# Advanced search
node {baseDir}/scripts/search.mjs "machine learning" --deep

# News search
node {baseDir}/scripts/search.mjs "AI news" --topic news

# Domain-filtered search
node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org

Options

Option	Description	Default
`-n <count>`	Number of results (1-20)	10
`--depth <mode>`	Search depth: `ultra-fast`, `fast`, `basic`, `advanced`	`basic`
`--topic <topic>`	Topic: `general` or `news`	`general`
`--time-range <range>`	Time range: `day`, `week`, `month`, `year`	-
`--include-domains <domains>`	Comma-separated domains to include	-
`--exclude-domains <domains>`	Comma-separated domains to exclude	-
`--raw-content`	Include full page content	false
`--json`	Output raw JSON	false

Search Depth

Depth	Latency	Relevance	Use Case
`ultra-fast`	Lowest	Lower	Real-time chat, autocomplete
`fast`	Low	Good	Need chunks but latency matters
`basic`	Medium	High	General-purpose, balanced
`advanced`	Higher	Highest	Precision matters, research

Tips

Keep queries under 400 characters - Think search query, not prompt
Break complex queries into sub-queries - Better results than one massive query
Use --include-domains to focus on trusted sources
Use --time-range for recent information
Filter by score (0-1) to get highest relevance results

Repository: UnicomAI/wanwu
Path: configs/microservice/bff-service/configs/agent-skills/clawhub/tavily-search/SKILL.md
Commit: f618458

Last updated: about 13 hours ago
First committed: 3 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.