---
id: BenedictKing/tavily-web/tavily-web
version: "6200eccc"
license: MIT
install: manual
updated: 2026-04-21
---

# tavily-web — Tavily Web integrates the Tavily API to handle multiple research workflows: search the web for current information, extract and summarize content from specific URLs, crawl sites to discover page structure, and generate structured research output. Route requests to the appropriate endpoint based on user intent—search for latest sources, extract for URL content, crawl for site traversal, map for page discovery, or research for schema-driven results.

Publisher: BenedictKing · Stars: 2 · Updated: 2026-04-21

Install (manual): `git clone https://github.com/BenedictKing/tavily-web`

## Decision gist

- What it does: Tavily Web searches the internet for current information and extracts content from URLs using the Tavily API.
- Install: `npx skillfed install BenedictKing/tavily-web/tavily-web` · manual: `git clone https://github.com/BenedictKing/tavily-web` → `cp -r tavily-web/.claude/skills/tavily-web ~/.claude/skills/tavily-web`
- Use it when: Yes, Tavily Web can extract and summarize content from specific URLs.
- Use it when: Tavily Web can crawl and map website structure to discover pages matching your criteria.
- Similar skills: intellectronica/agent-skills/tavily, gooseworks-ai/goose-skills/web-search-tavily, family3253/skill/tavily-crawl, openclaw/openclaw/tavily, itechmeat/llm-code/tavily
- Verify: Read SKILL.md below before installing

## SKILL.md

# Tavily Web Skill

## Trigger Conditions & Endpoint Selection

Choose Tavily endpoint based on user intent:

- **search**: Need to "search web / latest info / find sources / find links"
- **extract**: Given URL(s), need to extract/summarize content
- **crawl**: Need to traverse site following instructions and scrape page content
- **map**: Need to discover site page list/structure (without full content or metadata only)
- **research**: Need structured research output following given `output_schema`

## Recommended Architecture (Main Skill + Sub-skill)

This skill uses a two-phase architecture:

1. **Main skill (current context)**: Understand user question → Choose endpoint → Assemble JSON payload
2. **Sub-skill (fork context)**: Only responsible for HTTP call execution, avoiding conversation history token waste

## Execution Method

Use Task tool to invoke `tavily-fetcher` sub-skill, passing command and JSON (stdin):

```
Task parameters:
- subagent_type: Bash
- description: "Call Tavily API"
- prompt: cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs <search|extract|crawl|map|research>
  { ...payload... }
  JSON
```

## Payload Examples (Based on Provided curl)

### 1) Search the web

```bash
cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs search
{
  "query": "who is Leo Messi?",
  "auto_parameters": false,
  "topic": "general",
  "search_depth": "basic",
  "chunks_per_source": 3,
  "max_results": 1,
  "time_range": null,
  "start_date": "2025-02-09",
  "end_date": "2025-12-29",
  "include_answer": false,
  "include_raw_content": false,
  "include_images": false,
  "include_image_descriptions": false,
  "include_favicon": false,
  "include_domains": [],
  "exclude_domains": [],
  "country": null,
  "include_usage": false
}
JSON
```

### 2) Extract webpages

```bash
cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs extract
{
  "urls": "https://en.wikipedia.org/wiki/Artificial_intelligence",
  "query": "<string>",
  "chunks_per_source": 3,
  "extract_depth": "basic",
  "include_images": false,
  "include_favicon": false,
  "format": "markdown",
  "timeout": "None",
  "include_usage": false
}
JSON
```

### 3) Crawl webpages

```bash
cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs crawl
{
  "url": "docs.tavily.com",
  "instructions": "Find all pages about the Python SDK",
  "chunks_per_source": 3,
  "max_depth": 1,
  "max_breadth": 20,
  "limit": 50,
  "select_paths": null,
  "select_domains": null,
  "exclude_paths": null,
  "exclude_domains": null,
  "allow_external": true,
  "include_images": false,
  "extract_depth": "basic",
  "format": "markdown",
  "include_favicon": false,
  "timeout": 150,
  "include_usage": false
}
JSON
```

### 4) Map webpages

```bash
cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs map
{
  "url": "docs.tavily.com",
  "instructions": "Find all pages about the Python SDK",
  "max_depth": 1,
  "max_breadth": 20,
  "limit": 50,
  "select_paths": null,
  "select_domains": null,
  "exclude_paths": null,
  "exclude_domains": null,
  "allow_external": true,
  "timeout": 150,
  "include_usage": false
}
JSON
```

### 5) Create Research Task

```bash
cat <<'JSON' | node .claude/skills/tavily-web/tavily-api.cjs research
{
  "input": "What are the latest developments in AI?",
  "model": "auto",
  "stream": false,
  "output_schema": {
    "properties": {
      "company": {
        "type": "string",
        "description": "The name of the company"
      },
      "key_metrics": {
        "type": "array",
        "description": "List of key performance metrics",
        "items": {
          "type": "string"
        }
      },
      "financial_details": {
        "type": "object",
        "description": "Detailed financial breakdown",
        "properties": {
          "operating_income": {
            "type": "number",
            "description": "Operating income for the period"
          }
        }
      }
    },
    "required": [
      "company"
    ]
  },
  "citation_format": "numbered"
}
JSON
```

## Environment Variables & API Key

Two ways to configure API Key (priority: environment variable > `.env`):

1. Environment variable: `TAVILY_API_KEY`
2. `.env` file: Place in `.claude/skills/tavily-web/.env`, can copy from `.env.example`


[View on SkillFed](https://skillfed.io/BenedictKing/tavily-web/tavily-web) · [View on GitHub](https://github.com/BenedictKing/tavily-web)