---
name: tavily
description: 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.
metadata: {"openclaw":{"requires":{"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}
---

# 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`.