# Search

> Web search with automatic provider fallback (Tavily → DuckDuckGo)

- Skill: `quantclaw/search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add quantclaw/search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quantclaw/search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: QuantClaw (https://skillmd.com/u/quantclaw)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/quantclaw/search

---


Use the `web_search` tool to search the web. Results include titles, URLs, and snippets.

**Tool:** `web_search`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | ✓ | Search query |
| `count` | integer | — | Number of results (1–10, default 5) |
| `freshness` | string | — | Time filter: `day`, `week`, `month`, `year` |

**Provider cascade** (first available key wins):
1. **Tavily** (`TAVILY_API_KEY`) — recommended, high-quality results
2. **DuckDuckGo** — free, no API key required, always available as fallback

Set `TAVILY_API_KEY` in your environment or config for best results:
```json
{ "providers": { "tavily": { "apiKey": "tvly-..." } } }
```

**Examples:**
```
web_search({"query": "latest OpenAI news"})
web_search({"query": "Python asyncio tutorial", "count": 3})
web_search({"query": "market open price TSLA", "freshness": "day"})
```

**Slash command:** `/search <query>` triggers an immediate web search.