Skill2.4k repo starsupdated 13d ago

tavily-search

Tavily Search retrieves web results optimized for language model consumption using Tavily's API, returning relevant content snippets, relevance scores, and metadata. Use this skill when Claude Code needs current information from the web, such as recent news, documentation, tutorials, or domain-specific knowledge that falls outside training data, with configurable search depth, result limits, and domain filtering options.

View source Repository: wanwu

Install in Claude Code

Copy

git clone --depth 1 https://github.com/UnicomAI/wanwu /tmp/tavily-search && cp -r /tmp/tavily-search/configs/microservice/bff-service/configs/agent-skills/clawhub/openclaw-tavily-search ~/.claude/skills/tavily-search

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Tavily Search

Use the bundled script to search the web with Tavily.

## Requirements

- Provide API key via either:
  - environment variable: `TAVILY_API_KEY`, or
  - `~/.openclaw/.env` line: `TAVILY_API_KEY=...`

## Commands

Run from the OpenClaw workspace:

```bash
# raw JSON (default)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5

# include short answer (if available)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --include-answer

# stable schema (closer to web_search): {query, results:[{title,url,snippet}], answer?}
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format brave

# human-readable Markdown list
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format md
```

## Output

### raw (default)
- JSON: `query`, optional `answer`, `results: [{title,url,content}]`

### brave
- JSON: `query`, optional `answer`, `results: [{title,url,snippet}]`

### md
- A compact Markdown list with title/url/snippet.

## Notes

- Keep `max-results` small by default (3–5) to reduce token/reading load.
- Prefer returning URLs + snippets; fetch full pages only when needed.