Web Search Plus：智能搜索引擎聚合工具，自动选择最佳结果，支持7大提供商

web-search-plus by robbyczgw-cla/web-search-plus

947 周安装量

20 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/robbyczgw-cla/web-search-plus --skill web-search-plus

AI/机器学习自动化生产力

🇨🇳中文介绍

Web Search Plus

无需选择搜索引擎。让技能为您代劳。

此技能连接 7 个搜索引擎提供商（Serper、Tavily、Querit、Exa、Perplexity、You.com、SearXNG），并自动为每个查询选择最佳的一个。购物问题？→ Google 结果。研究问题？→ 深度研究引擎。需要直接答案？→ 带引用的 AI 综合答案。注重隐私？→ 自托管选项。

✨ 有何不同之处？

只管搜索 — 无需思考使用哪个提供商
智能路由 — 分析您的查询并自动选择最佳提供商
7 个提供商，1 个接口 — Google 结果、研究引擎、神经搜索、带引用的 AI 答案、RAG 优化和隐私优先，集于一身
仅需 1 个密钥即可使用 — 从任意单个提供商开始，后续可添加更多
提供免费选项 — SearXNG 完全免费（自托管）

🚀 快速开始

# 交互式设置（首次运行推荐）
python3 scripts/setup.py

# 或手动：复制配置文件并添加您的密钥
cp config.example.json config.json

向导会解释每个提供商，收集 API 密钥并配置默认设置。

🔑 API 密钥

您只需要一个密钥即可开始使用。后续可以添加更多提供商以获得更好的覆盖范围。

提供商	免费额度	最适合	注册链接

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🎯 何时使用哪个提供商

我想...	提供商	示例查询
查找产品价格	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	$	免费

我需要所有提供商的 API 密钥吗？

不需要。 您只需要您想使用的提供商的密钥。从一个开始（推荐 Serper），后续再添加更多。

我应该从哪个提供商开始？

Serper — 最快、最便宜、免费额度最大（每月 2,500 次查询），并且能很好地处理大多数查询。

如果免费查询用完了怎么办？

该技能会自动回退到您配置的其他提供商。或者切换到 SearXNG（无限，自托管）。

这需要多少钱？

免费额度： 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 每月 4,500+ 次免费搜索
SearXNG： 完全免费（如果您在 VPS 上自托管，每月只需约 5 美元）
付费计划： 根据提供商不同，每月约 10-50 美元起

SearXNG 真的私密吗？

是的，如果自托管。 您控制服务器，无追踪，无画像分析。公共实例取决于运营者的政策。

如何设置 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 协议
阻止云元数据端点（169.254.169.254, metadata.google.internal）
解析主机名并阻止私有/内部 IP（环回、RFC1918、链路本地、保留地址）
有意在私有网络上自托管的操作员可以设置 SEARXNG_ALLOW_PRIVATE=1

FAQ.md — 更多问题的详细解答
TROUBLESHOOTING.md — 修复常见错误
README.md — 完整技术参考

Serper — Google 搜索 API
Tavily — AI 研究搜索
Exa — 神经搜索
Perplexity — AI 综合答案（通过 Kilo Gateway）
You.com — RAG/实时搜索
SearXNG — 隐私优先元搜索

🇺🇸English

Web Search Plus

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.

✨ 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
7 providers, 1 interface — Google results, research engines, neural search, AI answers with citations, 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.

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" } }

🎯 When to Use Which Provider

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.

🧠 How Auto-Routing Works

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"

📖 Usage Examples

Let Auto-Routing Choose (Recommended)

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"

Force a Specific Provider

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"

⚙ Configuration

{
  "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"}
}

📊 Provider Comparison

Feature	Serper	Tavily	Exa	Perplexity	You.com	SearXNG
Speed	⚡⚡⚡	⚡⚡	⚡⚡	⚡⚡	⚡⚡⚡	⚡⚡
Direct Answers	✗	✗	✗	✓✓	✗	✗
Citations	✗	✗	✗	✓	✗	✗
Factual Accuracy	⭐⭐⭐	⭐⭐⭐	⭐⭐	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐

❓ Common Questions

Do I need API keys for all providers?

No. You only need keys for providers you want to use. Start with one (Serper recommended), add more later.

Which provider should I start with?

Serper — fastest, cheapest, largest free tier (2,500 queries/month), and handles most queries well.

What if I run out of free queries?

The skill automatically falls back to your other configured providers. Or switch to SearXNG (unlimited, self-hosted).

How much does this cost?

Free tiers: 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 4,500+ free searches/month
SearXNG: Completely free (just ~$5/mo if you self-host on a VPS)
Paid plans: Start around $10-50/month depending on provider

Is SearXNG really private?

Yes, if self-hosted. You control the server, no tracking, no profiling. Public instances depend on the operator's policy.

How do I set up SearXNG?

# Docker (5 minutes)
docker run -d -p 8080:8080 searxng/searxng

Then enable JSON API in settings.yml. See docs.searxng.org.

Why did it route my query to the "wrong" provider?

Sometimes queries are ambiguous. Use --explain-routing to see why, then override with -p provider if needed.

🔄 Automatic Fallback

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.

📤 Output Format

{
  "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"
  }
}

⚠ Important Note

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

🔒 Security

SearXNG SSRF Protection: The SearXNG instance URL is validated with defense-in-depth:

Enforces http/https schemes only
Blocks cloud metadata endpoints (169.254.169.254, metadata.google.internal)
Resolves hostnames and blocks private/internal IPs (loopback, RFC1918, link-local, reserved)
Operators who intentionally self-host on private networks can set SEARXNG_ALLOW_PRIVATE=1

📚 More Documentation

FAQ.md — Detailed answers to more questions
TROUBLESHOOTING.md — Fix common errors
README.md — Full technical reference

🔗 Quick Links

Serper — Google Search API
Tavily — AI Research Search
Exa — Neural Search
Perplexity — AI-Synthesized Answers (via Kilo Gateway)
You.com — RAG/Real-time Search
SearXNG — Privacy-First Meta-Search

Weekly Installs

947

Repository

robbyczgw-cla/w…rch-plus

GitHub Stars

First Seen

Feb 2, 2026

Security Audits

Gen Agent Trust HubPass SocketWarn SnykWarn

Installed on

opencode926

codex921

gemini-cli921

cursor918

github-copilot917

kimi-cli914

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

103,800 周安装

Web Search Plus：智能搜索引擎聚合工具，自动选择最佳结果，支持7大提供商

🇨🇳中文介绍

Web Search Plus

✨ 有何不同之处？

🚀 快速开始

🔑 API 密钥

相关 Skills

🎯 何时使用哪个提供商

🧠 自动路由如何工作

📖 使用示例

让自动路由选择（推荐）

强制使用特定提供商

⚙ 配置

📊 提供商对比

❓ 常见问题

我需要所有提供商的 API 密钥吗？

我应该从哪个提供商开始？

如果免费查询用完了怎么办？

这需要多少钱？

SearXNG 真的私密吗？

如何设置 SearXNG？

为什么它把我的查询路由到了“错误”的提供商？

🔄 自动回退

📤 输出格式

⚠ 重要提示

🔒 安全性

📚 更多文档

🔗 快速链接

🇺🇸English

Web Search Plus

✨ What Makes This Different?

🚀 Quick Start

🔑 API Keys

🎯 When to Use Which Provider

🧠 How Auto-Routing Works

📖 Usage Examples

Let Auto-Routing Choose (Recommended)

Force a Specific Provider

⚙ Configuration

📊 Provider Comparison

❓ Common Questions

Do I need API keys for all providers?

Which provider should I start with?

What if I run out of free queries?

How much does this cost?

Is SearXNG really private?

How do I set up SearXNG?

Why did it route my query to the "wrong" provider?

🔄 Automatic Fallback

📤 Output Format

⚠ Important Note

🔒 Security

📚 More Documentation

🔗 Quick Links

最新 Skills