web-search-plus by robbyczgw-cla/web-search-plus
npx skills add https://github.com/robbyczgw-cla/web-search-plus --skill web-search-plus无需选择搜索引擎。让技能为您代劳。
此技能连接 7 个搜索引擎提供商(Serper、Tavily、Querit、Exa、Perplexity、You.com、SearXNG),并自动为每个查询选择最佳的一个。购物问题?→ Google 结果。研究问题?→ 深度研究引擎。需要直接答案?→ 带引用的 AI 综合答案。注重隐私?→ 自托管选项。
# 交互式设置(首次运行推荐)
python3 scripts/setup.py
# 或手动:复制配置文件并添加您的密钥
cp config.example.json config.json
向导会解释每个提供商,收集 API 密钥并配置默认设置。
您只需要 一个 密钥即可开始使用。后续可以添加更多提供商以获得更好的覆盖范围。
| 提供商 | 免费额度 | 最适合 | 注册链接 |
|---|---|---|---|
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 2,500 次/月 |
| 购物、价格、本地、新闻 |
| serper.dev |
| Tavily | 1,000 次/月 | 研究、解释、学术 | tavily.com |
| Querit | 联系销售/免费额度各异 | 多语言 AI 搜索、国际更新 | querit.ai |
| Exa | 1,000 次/月 | "类似于 X"、初创公司、论文 | exa.ai |
| Perplexity | 通过 Kilo | 带引用的直接答案 | kilo.ai |
| You.com | 有限 | 实时信息、AI/RAG 上下文 | api.you.com |
| SearXNG | 免费 ✅ | 隐私、多源、零成本 | 自托管 |
设置您的密钥:
# 选项 A: .env 文件(推荐)
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"
export QUERIT_API_KEY="your-key"
# 选项 B: config.json
{ "serper": { "api_key": "your-key" } }
| 我想... | 提供商 | 示例查询 |
|---|---|---|
| 查找产品价格 | Serper | "iPhone 16 Pro Max 价格" |
| 查找附近的餐厅/商店 | Serper | "附近最好的披萨店" |
| 了解某物工作原理 | Tavily | "HTTPS 加密如何工作" |
| 进行深入研究 | Tavily | "2024 年气候变化研究" |
| 跨语言搜索 / 国际更新 | Querit | "德国最新 AI 政策更新" |
| 查找类似 X 的公司 | Exa | "类似于 Notion 的初创公司" |
| 查找研究论文 | Exa | "transformer 架构论文" |
| 获取带来源的直接答案 | Perplexity | "本周末柏林活动" |
| 了解某物的当前状态 | Perplexity | "以太坊升级状态如何" |
| 获取实时信息 | You.com | "最新 AI 监管新闻" |
| 无追踪搜索 | SearXNG | 任何内容,私密地 |
专业提示: 正常搜索即可!自动路由能正确处理大多数查询。需要时使用 -p provider 覆盖。
该技能会查看您的查询并选择最佳提供商:
"iPhone 16 price" → Serper (购物关键词)
"how does quantum computing work" → Tavily (研究问题)
"latest AI policy updates in Germany" → Querit (多语言 + 时效性)
"companies like stripe.com" → Exa (检测到 URL,相似性)
"events in Graz this weekend" → Perplexity (本地 + 直接答案)
"latest news on AI" → You.com (实时意图)
"search privately" → SearXNG (隐私关键词)
如果选错了怎么办? 覆盖它:python3 scripts/search.py -p tavily -q "your query"
调试路由: python3 scripts/search.py --explain-routing -q "your query"
python3 scripts/search.py -q "Tesla Model 3 price"
python3 scripts/search.py -q "explain machine learning"
python3 scripts/search.py -q "latest AI policy updates in Germany"
python3 scripts/search.py -q "startups like Figma"
python3 scripts/search.py -p serper -q "weather Berlin"
python3 scripts/search.py -p tavily -q "quantum computing" --depth advanced
python3 scripts/search.py -p querit -q "latest AI policy updates in Germany"
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "breaking tech news" --include-news
python3 scripts/search.py -p searxng -q "linux distros" --engines "google,bing"
{
"auto_routing": {
"enabled": true,
"fallback_provider": "serper",
"confidence_threshold": 0.3,
"disabled_providers": []
},
"serper": {"country": "us", "language": "en"},
"tavily": {"depth": "advanced"},
"exa": {"type": "neural"},
"you": {"country": "US", "include_news": true},
"searxng": {"instance_url": "https://your-instance.example.com"}
}
| 功能 | Serper | Tavily | Exa | Perplexity | You.com | SearXNG |
|---|---|---|---|---|---|---|
| 速度 | ⚡⚡⚡ | ⚡⚡ | ⚡⚡ | ⚡⚡ | ⚡⚡⚡ | ⚡⚡ |
| 直接答案 | ✗ | ✗ | ✗ | ✓✓ | ✗ | ✗ |
| 引用 | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ |
| 事实准确性 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| 语义理解 | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐ |
| 完整页面内容 | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| 购物/本地 | ✓ | ✗ | ✗ | ✗ | ✗ | ✓ |
| 查找相似页面 | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ |
| RAG 优化 | ✗ | ✓ | ✗ | ✗ | ✓✓ | ✗ |
| 隐私优先 | ✗ | ✗ | ✗ | ✗ | ✗ | ✓✓ |
| API 成本 | $$ | $$ | $$ | 通过 Kilo | $ | 免费 |
不需要。 您只需要您想使用的提供商的密钥。从一个开始(推荐 Serper),后续再添加更多。
Serper — 最快、最便宜、免费额度最大(每月 2,500 次查询),并且能很好地处理大多数查询。
该技能会自动回退到您配置的其他提供商。或者切换到 SearXNG(无限,自托管)。
是的,如果自托管。 您控制服务器,无追踪,无画像分析。公共实例取决于运营者的政策。
# Docker (5 分钟)
docker run -d -p 8080:8080 searxng/searxng
然后在 settings.yml 中启用 JSON API。参见 docs.searxng.org。
有时查询是模糊的。使用 --explain-routing 查看原因,然后如果需要,使用 -p provider 覆盖。
如果一个提供商失败(速率限制、超时、错误),该技能会自动尝试下一个提供商。发生这种情况时,您会在响应中看到 routing.fallback_used: true。
{
"provider": "serper",
"query": "iPhone 16 price",
"results": [{"title": "...", "url": "...", "snippet": "...", "score": 0.95}],
"routing": {
"auto_routed": true,
"provider": "serper",
"confidence": 0.78,
"confidence_level": "high"
}
}
Tavily、Serper 和 Exa 不是核心 OpenClaw 提供商。
❌ 不要为这些修改 ~/.openclaw/openclaw.json
✅ 使用此技能的脚本 — 密钥会自动从 .env 加载
SearXNG SSRF 防护: SearXNG 实例 URL 经过深度防御验证:
http/https 协议SEARXNG_ALLOW_PRIVATE=1每周安装次数
947
代码仓库
GitHub 星标数
20
首次出现
2026年2月2日
安全审计
安装于
opencode926
codex921
gemini-cli921
cursor918
github-copilot917
kimi-cli914
Stop choosing search providers. Let the skill do it for you.
This skill connects you to 7 search providers (Serper, Tavily, Querit, Exa, Perplexity, You.com, SearXNG) and automatically picks the best one for each query. Shopping question? → Google results. Research question? → Deep research engine. Need a direct answer? → AI-synthesized with citations. Want privacy? → Self-hosted option.
# 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.
You only need ONE key to get started. Add more providers later for better coverage.
| Provider | Free Tier | Best For | Sign Up |
|---|---|---|---|
| Serper | 2,500/mo | Shopping, prices, local, news | serper.dev |
| Tavily | 1,000/mo | Research, explanations, academic | tavily.com |
| Querit | Contact sales/free tier varies | Multilingual AI search, international updates | querit.ai |
| Exa | 1,000/mo | "Similar to X", startups, papers | exa.ai |
| Perplexity | Via Kilo | Direct answers with citations | kilo.ai |
| You.com | Limited | Real-time info, AI/RAG context |
Setting your keys:
# Option A: .env file (recommended)
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"
export QUERIT_API_KEY="your-key"
# Option B: config.json
{ "serper": { "api_key": "your-key" } }
| I want to... | Provider | Example Query |
|---|---|---|
| Find product prices | Serper | "iPhone 16 Pro Max price" |
| Find restaurants/stores nearby | Serper | "best pizza near me" |
| Understand how something works | Tavily | "how does HTTPS encryption work" |
| Do deep research | Tavily | "climate change research 2024" |
| Search across languages / international updates | Querit | "latest AI policy updates in Germany" |
| Find companies like X | Exa | "startups similar to Notion" |
| Find research papers | Exa | "transformer architecture papers" |
| Get a direct answer with sources |
Pro tip: Just search normally! Auto-routing handles most queries correctly. Override with -p provider when needed.
The skill looks at your query and picks the best provider:
"iPhone 16 price" → Serper (shopping keywords)
"how does quantum computing work" → Tavily (research question)
"latest AI policy updates in Germany" → Querit (multilingual + recency)
"companies like stripe.com" → Exa (URL detected, similarity)
"events in Graz this weekend" → Perplexity (local + direct answer)
"latest news on AI" → You.com (real-time intent)
"search privately" → SearXNG (privacy keywords)
What if it picks wrong? Override it: python3 scripts/search.py -p tavily -q "your query"
Debug routing: python3 scripts/search.py --explain-routing -q "your query"
python3 scripts/search.py -q "Tesla Model 3 price"
python3 scripts/search.py -q "explain machine learning"
python3 scripts/search.py -q "latest AI policy updates in Germany"
python3 scripts/search.py -q "startups like Figma"
python3 scripts/search.py -p serper -q "weather Berlin"
python3 scripts/search.py -p tavily -q "quantum computing" --depth advanced
python3 scripts/search.py -p querit -q "latest AI policy updates in Germany"
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "breaking tech news" --include-news
python3 scripts/search.py -p searxng -q "linux distros" --engines "google,bing"
{
"auto_routing": {
"enabled": true,
"fallback_provider": "serper",
"confidence_threshold": 0.3,
"disabled_providers": []
},
"serper": {"country": "us", "language": "en"},
"tavily": {"depth": "advanced"},
"exa": {"type": "neural"},
"you": {"country": "US", "include_news": true},
"searxng": {"instance_url": "https://your-instance.example.com"}
}
| Feature | Serper | Tavily | Exa | Perplexity | You.com | SearXNG |
|---|---|---|---|---|---|---|
| Speed | ⚡⚡⚡ | ⚡⚡ | ⚡⚡ | ⚡⚡ | ⚡⚡⚡ | ⚡⚡ |
| Direct Answers | ✗ | ✗ | ✗ | ✓✓ | ✗ | ✗ |
| Citations | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ |
| Factual Accuracy | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
No. You only need keys for providers you want to use. Start with one (Serper recommended), add more later.
Serper — fastest, cheapest, largest free tier (2,500 queries/month), and handles most queries well.
The skill automatically falls back to your other configured providers. Or switch to SearXNG (unlimited, self-hosted).
Yes, if self-hosted. You control the server, no tracking, no profiling. Public instances depend on the operator's policy.
# Docker (5 minutes)
docker run -d -p 8080:8080 searxng/searxng
Then enable JSON API in settings.yml. See docs.searxng.org.
Sometimes queries are ambiguous. Use --explain-routing to see why, then override with -p provider if needed.
If one provider fails (rate limit, timeout, error), the skill automatically tries the next provider. You'll see routing.fallback_used: true in the response when this happens.
{
"provider": "serper",
"query": "iPhone 16 price",
"results": [{"title": "...", "url": "...", "snippet": "...", "score": 0.95}],
"routing": {
"auto_routed": true,
"provider": "serper",
"confidence": 0.78,
"confidence_level": "high"
}
}
Tavily, Serper, and Exa are NOT core OpenClaw providers.
❌ Don't modify ~/.openclaw/openclaw.json for these
✅ Use this skill's scripts — keys auto-load from .env
SearXNG SSRF Protection: The SearXNG instance URL is validated with defense-in-depth:
http/https schemes onlySEARXNG_ALLOW_PRIVATE=1Weekly Installs
947
Repository
GitHub Stars
20
First Seen
Feb 2, 2026
Security Audits
Gen Agent Trust HubPassSocketWarnSnykWarn
Installed on
opencode926
codex921
gemini-cli921
cursor918
github-copilot917
kimi-cli914
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
103,800 周安装
| SearXNG | FREE ✅ | Privacy, multi-source, $0 cost | Self-hosted |
| Perplexity |
| "events in Berlin this weekend" |
| Know the current status of something | Perplexity | "what is the status of Ethereum upgrades" |
| Get real-time info | You.com | "latest AI regulation news" |
| Search without being tracked | SearXNG | anything, privately |
| Semantic Understanding | ⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐ |
| Full Page Content | ✗ | ✓ | ✓ | ✓ | ✓ | ✗ |
| Shopping/Local | ✓ | ✗ | ✗ | ✗ | ✗ | ✓ |
| Find Similar Pages | ✗ | ✗ | ✓ | ✗ | ✗ | ✗ |
| RAG-Optimized | ✗ | ✓ | ✗ | ✗ | ✓✓ | ✗ |
| Privacy-First | ✗ | ✗ | ✗ | ✗ | ✗ | ✓✓ |
| API Cost | $$ | $$ | $$ | Via Kilo | $ | FREE |