Web Search Plus

网页搜索 Plus

停止选择搜索提供商。让技能为你做事。

这项技能可将你连接到 5 个搜索提供商（Serper、Tavily、Exa、You.com、SearXNG），并自动为每个查询选择最佳搜索提供商。购物问题？→ Google 结果。研究问题？→ 深度研究引擎。想要隐私？→ 自托管选项。

✨ 有何不同？

• 只需搜索 — 无需考虑使用哪个提供商
• 智能路由 — 分析你的查询并自动选择最佳提供商
• 5 个提供商，1 个界面 — Google 结果、研究引擎、神经搜索、RAG 优化和隐私优先集于一身
• 只需 1 个密钥即可使用 — 从任何单个提供商开始，稍后添加更多提供商
• 提供免费选项 — SearXNG 完全免费（自托管）

🚀 快速入门

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

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

该向导解释每个提供程序、收集 API 密钥并配置默认值。

🔑 API 密钥

你只需要一把钥匙即可开始。稍后添加更多提供商以获得更好的覆盖范围。

设置你的密钥：

# 选项 A：.env 文件（推荐）
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"

# 选项 B：config.json
{ "serper": { "api_key": "your-key" } }

🎯 何时使用哪个提供商

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

🧠 自动路由的工作原理

该技能会查看你的查询并选择最佳的提供商：

"iPhone 16 price"              → Serper (购物关键词)
"how does quantum computing work" → Tavily (研究问题)
"companies like stripe.com"    → Exa (检测到 URL，相似性)
"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 "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 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"}
}

📊 提供商比较

❓ 常见问题

我是否需要所有提供商的 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 — 神经搜索
• You.com — RAG/实时搜索
• SearXNG — 隐私优先元搜索