# Tavily

> Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results.

- Skill: `modbender/tavily-3` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add modbender/tavily-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/tavily-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/modbender/tavily-3

---


# Tavily

Use the bundled CLI to run Tavily searches from the terminal and collect sources fast.

## Quick start (CLI)

The scripts **require** `TAVILY_API_KEY` in the environment (sent as `Authorization: Bearer ...`).

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "best rust http client" --max_results 5
```

- JSON response is printed to **stdout**.
- A simple URL list is printed to **stderr** by default.

## Common patterns

### Get URLs only

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "OpenTelemetry collector config" --urls-only
```

### Restrict to (or exclude) specific domains

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js \
  --query "oauth device code flow" \
  --include_domains oauth.net,datatracker.ietf.org \
  --exclude_domains medium.com
```

## Notes

- The bundled CLI supports a subset of Tavily’s request fields (query, max_results, include_domains, exclude_domains).
- For API field notes and more examples, read: `references/tavily-api.md`.
- Wrapper script (optional): `scripts/tavily_search.sh`.