Skip to main content
skill CX Codex

tavily-search · tavily-ai, core — Claude Code skill: web search and page extraction

tavily-search — a skill for Claude Code that enables web searching and data extraction from webpages. Use it to verify facts, read current news, and gather information beyond the model's training data.

MIT 39,400 installs ★ 497 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tavily-ai/skills --skill tavily-search -a claude-code
Open on GitHub

What tavily-search does

The skill adds tools for web interaction: tavily_search, tavily_extract, tavily_map, and tavily_crawl. It allows the agent to search for information, extract text from pages, or crawl site sections. If tools are available via MCP, use them directly; otherwise, run the tvly CLI command.

Save results to the .tavily/ directory using the -o flag to avoid context overflow and enable file reuse. Formulate queries like a search engine, splitting complex questions into focused parts. When handling JavaScript-rendered pages or tables, set extract_depth to advanced.

What it helps with

  • Verify current facts or news
  • Extract content from a specific URL
  • Gather data from all pages in a site section
  • Retrieve information outside the model's training data

Example prompts for the agent

  • tvly search 'latest Rust release date' --depth advanced --max-results 10
  • tvly extract 'https://example.com/report' -o .tavily/report.json

How to install tavily-search

1Skills CLI (Vercel)

npx skills add tavily-ai/skills --skill tavily-search -a claude-code

2Manually: put the files in place

~/.claude/skills/tavily-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tavily-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tavily-search

How to install tavily-search in Claude Code?

Run npx skills add tavily-ai/skills --skill tavily-search -a claude-code in your project terminal.

What does tavily-search do?

It enables the agent to search the web, read URLs, and extract data when the model's training knowledge is insufficient.

What is required to run tavily-search?

The skill relies on tvly CLI or MCP tools, which must be available in your execution environment.

Source text

SKILL.md · MIT
---
name: tavily-search
description: |
  Use this skill whenever a task needs the web: searching for information, checking current facts or news, finding sources, reading a URL, finding a page on a site, or collecting many pages from a site. Use it for anything past your training data or anything the user wants verified online.
allowed-tools: Bash(tvly *)
---

# Tavily search

Use the `tavily_search`, `tavily_extract`, `tavily_map` and `tavily_crawl` tools if your tool list has them
(some clients add a prefix such as `mcp__tavily__`). Otherwise run `tvly <command>` directly; there's no
need to check for it first. If neither works, follow [setup](references/setup.md).

Parameters are named as in the API (`max_results`). The CLI spells them as flags (`--max-results`) with
comma-separated lists (`--include-domains sec.gov,reuters.com`). For exact parameters, read the tool schema,
run `tvly <command> --help`, or see the [API reference](https://docs.tavily.com/documentation/api-reference/endpoint/search).

| You have | You need | Use |
|---|---|---|
| A question or topic | Sources, facts or news | Search |
| URLs | Their content | Extract |
| A site, not the exact page | The right page's URL | [Map](references/map.md) |
| A site section | Many of its pages | [Crawl](references/crawl.md) |

## Search

**Use advanced search.** Set `search_depth` to `advanced` (`--depth advanced` in the CLI) for every search
unless the user needs a fast answer to a simple lookup. It reaches more sources and ranks the passages that match your query.

**Write queries for a search engine.** Use the names and terms you expect on the page, not the user's whole
request. Split a question with several parts into one focused search per part. For a long written report,
search each part separately and extract the main sources for each before you write.

**Follow your leads.** When a result names a likely answer, test it right away: search that name with the
other details you know, or extract its page. Keep a lead that fits most details until a source contradicts it; a detail you can't confirm doesn't rule it out. When a search misses,
search the details again in their own words before adding names or filters you guessed, and build lists of
candidates from results, not memory. When a detail keeps coming back empty, work out what it refers to, such as
the role, event or term, and search for that.

`tvly search` prints each result's title, full URL and the first 600 characters of its matching passages. Add
`-o .tavily/<name>.json` to also save every result whole, so you can go back to it instead of searching again.
`--max-chars 0` prints the passages whole. Read a promising page in full with `tvly extract <url>`.

**Batch independent searches.** Issue the searches for one step together in one turn, one call each: separate
`tavily_search` calls with MCP tools, or separate Bash calls with the CLI, each holding a single `tvly` command.
MCP calls run in parallel; Bash calls run one after another but still use one turn. Avoid `&`, `$(...)` and
loops, which make the client ask for permission. Put the query in single quotes:
`tvly search 'Rust 2024 edition release date' --depth advanced --max-results 10 -o .tavily/rust-2024.json`.

**Work from saved files.** Keep results in `.tavily/` in the current folder and read them with `head`, `grep` or
`python3`. `-o` creates the folder and keeps it out of git, so don't create it yourself. For example, to find a name or number in a long page:

```bash
tvly extract 'https://example.com/report' -o .tavily/report.json
python3 -c 'import json,re; t=json.load(open(".tavily/report.json"))["results"][0]["raw_content"]; [print(t[max(0,m.start()-200):m.end()+200], "\n---") for m in re.finditer("2019", t)]'
```

Read pages with `tvly extract`, not `curl` or `wget`.

**Ask for 10 results.** Set `max_results` to 10 (`--max-results 10`). **Narrow before you widen.** Filters help more than raising `max_results` further. Use `time_range` or dates for
recent events or a stated period. Use `include_domains` when the answer lives on an official or named site; it
is a hard filter, so search again without it if it doesn't find the page.

**Keep large results on disk.** When a result is long, such as raw page content or a crawl, save it under
`.tavily/` and read only the parts you need. An MCP result lands straight in your context, so keep those calls
small.

**Save copies with `-o`.** Saving results to files is a job for `tvly`: run the call with
`-o .tavily/<name>.json`, even if you searched with MCP tools. A file you write from an MCP result is your
retyping of it, not the original. Without `tvly`, work from the results in your context and don't copy them
into files. If the user asked for a saved copy, give them the URLs and queries, say an exact copy needs the
CLI, and write a retyped copy only if they ask for one.

**Read the results critically.** Count independent sources, not results. Treat a generated answer as a summary
to check, never as a source.

## Extract

Extract returns up to 20 URLs per call as markdown, including pages built with JavaScript.

- Extract only the few results worth reading. Snippets answer most facts.
- Extract full pages by default. Pass `query` (`--query`) only to isolate one fact on a long page; if the passages come
  back cut off near what you need, extract again without it.
- Rerun with `extract_depth` set to `advanced` (`--extract-depth advanced`) when a page is built with JavaScript, the content is in a table, or
  `basic` came back empty. Check `failed_results` every time and say which pages couldn't be read.

## When to stop

- Stop once two independent sources agree on a fact.
- Before you answer, close any gap your draft would mark unconfirmed or fill from memory: run one targeted
  search or reread the saved page.
- For releases, ownership, official figures and decisions by a named body, confirm on the official domain or
  repository. A secondary site or a generated answer is not enough.

## Hand off the job

When the user wants an in-depth report that needs many sources gathered and weighed, such as an analysis, a
comparison across several criteria or an in-depth investigation, use `tavily-research` instead of your own searches.
If it isn't installed, run `npx skills add tavily-ai/skills --skill tavily-research` and read its SKILL.md first. A
single fact or answer to find stays here.

© tavily-ai · MIT · tavily-ai/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

tavily-search by other authors comes first.

tavily-search tavily-ai tavily-search is a Claude Code and Codex skill that searches the web and returns relevant pages with text snippets, relevance scores, and metadata for LLM workflows. CX Codex +1 39,400installs tavily-search framix-team tavily-search integrates Tavily API into your coding agent for web search, text extraction, site crawling, and research reports. Works as an AI-oriented search replacement. CX Codex +1 843installs tavily-search veithly tavily-search connects Tavily AI search API to fetch fresh web information and real-time facts. Helpful whenever an agent needs recent updates from outside its training data. CX Codex +1 3,700installs tavily intellectronica Searches the web, extracts page content, maps domains, and runs deep research tasks through Tavily's REST API. CX Codex +1 636installs tavily-tools Fatih C. Akyon tavily-tools gives the agent web search and page extraction through Tavily, and can point the built-in web tools at the same service. CX Codex ★ 1,216repo stars web-search-tavily agent-skills web-search-tavily — a skill that runs web searches through the Tavily API and returns structured results with relevance scores. Useful when the agent needs current data from the web. CX Codex +1 1,100installs tavily-web davila7 tavily-web connects Claude Code to the Tavily API for online searches, webpage crawling, and extracting text content directly from URLs. CX Codex +1 94installs tavily-usage fcakyon tavily-usage guides coding agents to run web searches and extract page content via Tavily MCP tools. Requires a Tavily API key. CX Codex +1 900installs tavily-mcp tavily-ai Gives your coding agent four Tavily tools: web search, page extraction, site mapping and crawling. Useful when you need fresh web context inside the editor. CX Codex +1 ★ 2,499repo stars

From the same set13

The whole set →
tavily-search tavily-search is a Claude Code and Codex skill that searches the web and returns relevant pages with text snippets, relevance scores, and metadata for LLM workflows. CX Codex +1 39,400installs tavily-research tavily-research — a skill for Claude Code and other platforms that gathers and weighs info from multiple sources. It triggers when performing in-depth analysis of markets, tech, or trends. CX Codex +1 25,100installs tavily-research tavily-research — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that runs tvly research, pulls sources from the web, and returns a cited report. Completes in 30–120 seconds. CX Codex +1 25,100installs tavily-best-practices The tavily-best-practices skill gives an agent guidance for Tavily web search, content extraction, site crawling, and research. Use it when adding current web data to an agent workflow or RAG system. CX Codex +1 21,100installs tavily-extract tavily-extract extracts clean text or Markdown from specified pages with Tavily CLI. Use it for JavaScript-rendered content or query-focused page chunks. CX Codex +1 18,600installs tavily-crawl tavily-crawl is a Claude Code skill that crawls websites and extracts documentation as Markdown files or focused text chunks for an agent. CX Codex +1 17,900installs tavily-map tavily-map — a skill that has the agent walk a site and hand back the list of addresses, leaving page text alone. Useful when you know the domain but not the page. CX Codex +1 17,600installs tavily-dynamic-search tavily-dynamic-search is a Claude Code skill that saves raw Tavily search results to disk and filters excerpts before they enter the model context, especially for full-page extraction or multiple queries. CX Codex +1 13,900installs

More in the catalog

Project sponsors

Companies that keep this analytics open