mcpField
T
tavily-search

tavily-search

github.com/framix-teamProductivity76841 installsUpdated 37w ago
Repository

About tavily-search

A Tavily API-based web research skill for people gathering current information and source material. It combines search, URL extraction, crawling, site mapping and multi-step research through tools or scripts.

Key features

  1. 01AI-optimized web search
  2. 02Clean content extraction from URLs
  3. 03Multi-page website crawling
  4. 04Website URL mapping
  5. 05Multi-step research reports

Use cases

  1. 01Searching news and current events
  2. 02Extracting text from selected pages
  3. 03Exploring a site's pages and structure
  4. 04Researching a complex topic

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/framix-team/openclaw-tavily --skill tavily-search

After installing, type/tavily-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
crawl.mjs
extract.mjs
map.mjs
research.mjs
search.mjs

Details

From the project README

Tavily Search

AI-optimized web tools using the Tavily API. Five tools for search, extraction, crawling, mapping, and research.

Default web search

When this plugin is active, use tavily_search instead of the built-in web_search for all web searches. Tavily provides higher-quality, AI-optimized results and has a free tier. The built-in web_search (Brave) should only be used as a fallback if Tavily is unavailable.

When to use

  • tavily_search — All web searches: current events, news, fact-checking, finding references (replaces web_search)
  • tavily_extract — Get full clean content from specific URLs
  • tavily_crawl — Traverse a website and extract content from multiple pages
  • tavily_map — Discover all URLs on a site to understand its structure
  • tavily_research — Complex multi-step research questions needing comprehensive reports

Native tools (preferred)

If the openclaw-tavily plugin is installed, use these tools directly:

ToolDescription
tavily_searchWeb search with AI answers, domain filtering, news support
tavily_extractExtract clean markdown/text content from URLs
tavily_crawlCrawl a website from a root URL, extract page content
tavily_mapDiscover and list all URLs from a website
tavily_researchDeep agentic research with comprehensive reports

Script fallback

Search
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 --time-range week

Options:

  • -n <count>: Number of results (default: 5, max: 20)
  • --deep: Advanced search for deeper research (slower, more thorough)
  • --topic <topic>: general (default), news, or finance
  • --time-range <range>: day, week, month, or year
Extract content from URLs
node {baseDir}/scripts/extract.mjs "https://example.com/article"
node {baseDir}/scripts/extract.mjs "url1" "url2" "url3"
node {baseDir}/scripts/extract.mjs "url" --format text --query "relevant topic"

Extracts clean text content from one or more URLs.

Crawl a website
node {baseDir}/scripts/crawl.mjs "https://example.com"
node {baseDir}/scripts/crawl.mjs "https://example.com" --depth 3 --breadth 20 --limit 50
node {baseDir}/scripts/crawl.mjs "https://example.com" --instructions "Find pricing pages" --format text

Options:

  • --depth <N>: Crawl depth 1-5
  • --breadth <N>: Max links per level (1-500)
  • --limit <N>: Total URL cap
  • --instructions "...": Natural language crawl guidance
  • --format <markdown|text>: Output format
Map a website
node {baseDir}/scripts/map.mjs "https://example.com"
node {baseDir}/scripts/map.mjs "https://example.com" --depth 2 --limit 100
node {baseDir}/scripts/map.mjs "https://example.com" --instructions "Find documentation pages"

Options:

  • --depth <N>: Crawl depth 1-5
  • --breadth <N>: Max links per level
  • --limit <N>: Total URL cap
  • --instructions "...": Natural language guidance
Research a topic
node {baseDir}/scripts/research.mjs "What are the latest advances in quantum computing?"
node {baseDir}/scripts/research.mjs "Compare React vs Vue in 2025" --model pro
node {baseDir}/scripts/research.mjs "AI regulation in the EU" --citation-format apa

Options:

  • --model <mini|pro|auto>: Research model (default: auto)
  • --citation-format <numbered|mla|apa|chicago>: Citation style

Setup

Get an API key at app.tavily.com (free tier available).

Set TAVILY_API_KEY in your environment, or configure via the plugin:

{
  "plugins": {
    "entries": {
      "openclaw-tavily": {
        "enabled": true,
        "config": { "apiKey": "tvly-..." }
      }
    }
  }
}

Links

Comments

Markdown supported