name: search emoji: "🔍" description: Web search with automatic provider fallback (Tavily → DuckDuckGo) always: true commands:
- name: search description: Search the web for a query toolName: web_search argMode: freeform
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):
- Tavily (
TAVILY_API_KEY) — recommended, high-quality results - DuckDuckGo — free, no API key required, always available as fallback
Set TAVILY_API_KEY in your environment or config for best results:
{ "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.