🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί tavily-search
πŸ¦€ ClawHub

tavily-search

by @quenfly

Tavily AI search API integration for OpenClaw. Provides web search functionality with AI-powered summarization optimized for RAG and question answering. Use...

Versionv1.0.0
Downloads423
#legal
TERMINAL
clawhub install tavily-search-quant

πŸ“– About This Skill

name: tavily-search description: Tavily AI search API integration for OpenClaw. Provides web search functionality with AI-powered summarization optimized for RAG and question answering. Use when you need web search and the default web_search tool is not configured or you prefer Tavily's search results.

Tavily Search

Tavily Search is a specialized AI search API designed for LLMs and RAG applications. It provides:

  • Real-time web search with AI-summarized results
  • Built-in content extraction
  • Date range filtering
  • Domain filtering
  • Free tier: 1000 searches/month

    • Configuration

    Before using, you need to configure your Tavily API key:

    1. Get your API key from https://tavily.com/ 2. Set it in your environment: export TAVILY_API_KEY=your_api_key_here 3. Or add it to OpenClaw config at tools.tavily.apiKey

    Core Capabilities

    1. Basic Search (tavily_search)

    Search the web with optional depth control and topic filtering.

    Parameters:

  • query (required): Search query string
  • max_results (optional, default 5): Number of results (1-10)
  • search_depth (optional): basic or deep (default basic)
  • topic (optional): general or news (default general)
  • days (optional): Time range in days back from current date

    • 2. Search with Date Range (tavily_search_date_range)

    Search with specific start and end dates.

    Parameters:

  • query (required): Search query string
  • start_date (required): YYYY-MM-DD
  • end_date (required): YYYY-MM-DD
  • max_results (optional, default 5)
  • search_depth (optional): basic or deep

    • 3. Q&A Search (tavily_answer)

    Get a direct AI answer to your question with citations.

    Parameters:

  • query (required): Question to answer
  • max_results (optional, default 5)
  • search_depth (optional): basic or deep

    • 4. Extract Content (tavily_extract)

    Extract clean, readable content from one or more URLs.

    Parameters:

  • urls (required): Array of URLs to extract

    • Usage Example

    # Search for recent news about OpenClaw
python scripts/tavily_search.py "openclaw github" --days 1 --max_results 5

    Output Format

    All search commands return JSON with:

  • results: Array of search results with title, content, url, score
  • answer: AI-generated answer (for answer mode)
  • response_time: Query response time

    • scripts/

    | Script | Purpose | |--------|---------| | tavily_cli.py | Main CLI interface for all Tavily search operations | | tavily_api.py | Python API client module |

    references/

    | File | Purpose | |------|---------| | api_docs.md | Tavily API documentation reference |

    βš™οΈ Configuration

    Before using, you need to configure your Tavily API key:

    1. Get your API key from https://tavily.com/ 2. Set it in your environment: export TAVILY_API_KEY=your_api_key_here 3. Or add it to OpenClaw config at tools.tavily.apiKey