Web Search Plus — 增强型网页搜索

无需选择搜索提供商，让技能为您做选择。

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

---

✨ 与其他搜索技能有何不同？

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

---

🚀 快速开始

# 交互式设置（首次运行推荐）
python3 scripts/setup.py
# 或手动：复制配置并添加您的密钥
cp config.example.json config.json

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

---

🔑 API 密钥

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

提供商	免费额度	最佳用途	注册链接
Serper	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 政策更新"
查找类似的公司	Exa	"类似 Notion 的创业公司"
查找研究论文	Exa	"Transformer 架构论文"
获取带来源的直接答案	Perplexity	"柏林这周末的活动"
了解某事物的当前状态	Perplexity	"以太坊升级的现状如何"
获取实时信息	You.com	"最新 AI 法规新闻"
无痕搜索	SearXNG	任何内容，隐私保护

专业提示： 正常搜索即可！自动路由在大多数查询上都能正确处理。需要时使用 -p provider 覆盖。

---

🧠 自动路由工作原理

技能会分析您的查询并选择最佳提供商：

"iPhone 16 价格"              → Serper (购物关键词)
"量子计算如何工作" → Tavily (研究问题)
"德国最新 AI 政策更新" → Querit (多语言+时效性)
"类似 stripe.com 的公司"    → Exa (检测到 URL，相似性)
"这周末在格拉茨的活动"  → Perplexity (本地+直接答案)
"最新 AI 新闻"            → You.com (实时意图)
"隐私搜索"             → SearXNG (隐私关键词)

如果选错了怎么办？ 覆盖它：python3 scripts/search.py -p tavily -q "您的查询"

调试路由： python3 scripts/search.py --explain-routing -q "您的查询"

---

📖 使用示例

让自动路由选择（推荐）

python3 scripts/search.py -q "特斯拉 Model 3 价格"
python3 scripts/search.py -q "解释机器学习"
python3 scripts/search.py -q "德国最新 AI 政策更新"
python3 scripts/search.py -q "类似 Figma 的公司"

强制使用特定提供商

python3 scripts/search.py -p serper -q "柏林天气"
python3 scripts/search.py -p tavily -q "量子计算" --depth advanced
python3 scripts/search.py -p querit -q "德国最新 AI 政策更新"
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "最新科技新闻" --include-news
python3 scripts/search.py -p searxng -q "Linux 发行版" --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： 完全免费（自托管约 $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 价格",
  "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 — 隐私优先元搜索