# Tavily Search

> >

- **Type:** Skill
- **Install:** `agentstack add skill-ericwang915-pythonclaw-tavily`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ericwang915](https://agentstack.voostack.com/s/ericwang915)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ericwang915](https://github.com/ericwang915)
- **Source:** https://github.com/ericwang915/PythonClaw/tree/main/pythonclaw/templates/skills/web/tavily
- **Website:** https://github.com/ericwang915/PythonClaw

## Install

```sh
agentstack add skill-ericwang915-pythonclaw-tavily
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Tavily Web Search

## When to Use

- [ ] Search the web for information
- [ ] Look up current events or news
- [ ] Research a topic with real-time results
- [ ] Check facts or verify claims
- [ ] Find data, articles, or summaries from the internet

## When NOT to Use

- [ ] Scraping a specific URL's content — use `web_scraper`
- [ ] Calling a known API endpoint — use `http_request`
- [ ] GitHub or code-specific lookups — use `github` or search

## Setup

1. Get a free API key at [app.tavily.com](https://app.tavily.com/home)
2. Add to `pythonclaw.json`:
   ```json
   "tavily": { "apiKey": "tvly-..." }
   ```
3. Install SDK: `pip install tavily-python`

## Usage/Commands

Use the built-in `web_search` tool — no script required.

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| `query` | string | Search query (be specific) | **required** |
| `search_depth` | string | `"basic"` (fast) or `"advanced"` (thorough) | `"basic"` |
| `topic` | string | `"general"`, `"news"`, or `"finance"` | `"general"` |
| `max_results` | integer | Results count (1–20) | 5 |
| `time_range` | string | `"day"`, `"week"`, `"month"`, `"year"` | none |

**Examples:**

```
web_search(query="Python 3.13 new features")
web_search(query="AI industry news", topic="news", time_range="week", max_results=10)
web_search(query="NVIDIA stock analysis 2026", topic="finance", search_depth="advanced")
```

## Notes

- Be specific in queries (e.g., "Python asyncio best practices 2026" vs "Python async")
- Use `topic="news"` for current events, `topic="finance"` for market data
- Use `time_range` when freshness matters
- Always cite source URLs in your response

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ericwang915](https://github.com/ericwang915)
- **Source:** [ericwang915/PythonClaw](https://github.com/ericwang915/PythonClaw)
- **License:** MIT
- **Homepage:** https://github.com/ericwang915/PythonClaw

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ericwang915-pythonclaw-tavily
- Seller: https://agentstack.voostack.com/s/ericwang915
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.