Web Search Plus

Stop choosing search providers. Let the skill do it for you.

This skill connects you to 5 search providers (Serper, Tavily, Exa, You.com, SearXNG) and automatically picks the best one for each query. Shopping question? → Google results. Research question? → Deep research engine. Want privacy? → Self-hosted option.

✨ What Makes This Different?

• Just search — No need to think about which provider to use
• Smart routing — Analyzes your query and picks the best provider automatically
• 5 providers, 1 interface — Google results, research engines, neural search, RAG-optimized, and privacy-first all in one
• Works with just 1 key — Start with any single provider, add more later
• Free options available — SearXNG is completely free (self-hosted)

🚀 Quick Start

# Interactive setup (recommended for first run)
python3 scripts/setup.py

# Or manual: copy config and add your keys
cp config.example.json config.json

The wizard explains each provider, collects API keys, and configures defaults.

🔑 API Keys

You only need ONE key to get started. Add more providers later for better coverage.

Setting your keys:

# Option A: .env file (recommended)
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"

# Option B: config.json
{ "serper": { "api_key": "your-key" } }

🎯 When to Use Which Provider

Pro tip: Just search normally! Auto-routing handles most queries correctly. Override with -p provider when needed.

🧠 How Auto-Routing Works

The skill looks at your query and picks the best provider: