首页 / 技能 / Free Search Aggregator — 多提供商智能搜索聚合器

📦 Free Search Aggregator — 多提供商智能搜索聚合器

v1.3.0

Free Search Aggregator 是 OpenClaw 的多提供商智能搜索聚合器，支持 12 个搜索提供商，自动故障转移，任务级深度搜索，真实配额检查和管理的结果存储。它提供高可用性、低运维开销的搜索解决方案，支持自我修复、质量优化、自动发现新源等功能。

1· 510·5 当前·5 累计
by @vulcanusalex (Tianqu)·MIT-0
开发工具API工具网络工具自动化
下载技能包
License
MIT-0
最后更新
2026/3/6
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
代码、文档和运行指令与声明的目的（多提供商搜索聚合器）一致，没有无关或不成比例的请求或实现。
评估建议
此技能如其所述：一个多提供商的 Web 搜索聚合器，会对配置的提供商和公共候选搜索实例执行出站 HTTP 请求，并在本地 `memory/` 下存储结果。安装前，请审查配置、注意发送敏感文本、仅提供可信服务的 API 密钥、确保 Python 依赖项、考虑沙盒运行、并定期检查 `memory/` 的保留策略。...
详细分析 ▾
✓ 用途与能力
名称/描述、README、SKILL.md、config/providers.yaml 和 Python 提供商实现都描述和实现了一个配额感知的多提供商 Web 搜索，具有故障转移、发现、健康追踪和本地持久性。
ℹ 指令范围
运行时指令和 CLI（doctor、discover、search、remaining、health、gc、setup）保持在搜索/诊断范围内。
ℹ 安装机制
没有安装规范（最低安装风险）。
✓ 凭证需求
没有声明强制凭据。
✓ 持久化与权限
技能在本地 `memory/` 工作空间下写入日志、健康记录、配额状态和搜索工件。
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.3.02026/2/28

新增健康监控与智能路由（按成功率/延迟自动调序）；新增质量优化（相关性评分、模糊去重、域名多样性）；新增来源自动发现（探测候选搜索引擎与 SearXNG）；补充自诊断命令 `doctor/setup` 与测试覆盖，文档同步更新。

● 无害

安装命令

点击复制
官方npx clawhub@latest install free-search-aggregator
镜像加速npx clawhub@latest install free-search-aggregator --registry https://cn.longxiaskill.com

技能文档

为 OpenClaw 提供可靠、多提供商的网络搜索服务，高可用性 + 低运维开销。

为什么使用此技能

  • 12个搜索提供商，其中6个完全不需要 API 密钥
  • 自动故障转移：如果一个提供商失败，立即尝试下一个
  • 配额感知：跟踪每日使用量，80% 时警告，跳过已耗尽的提供商
  • 任务级多查询搜索模式，适用于多角度研究查询
  • 内置存储生命周期（缓存/索引/报告），不产生工作区混乱
  • 自我修复：基于健康状态的智能路由自动提升可靠提供商
  • 质量优化：相关性评分、模糊去重、域名多样性、重新排序
  • 自动发现：探测候选搜索引擎和 SearXNG 实例以发现新来源
  • 自诊断：doctor 和 setup 命令实现零摩擦入门

提供商概览

提供商需要密钥免费配额索引来源备注
braveBRAVE_API_KEY2000/天Brave 独立索引高质量，隐私友好
exaEXA_API_KEY~33/天（1k/月）神经 + 网络语义搜索，独特发现
tavilyTAVILY_API_KEY1000/天网络（AI优化）专为 AI 代理设计
duckduckgo无~500/天Bing + 自有索引无密钥，隐私优先
bing_html无~300/天Microsoft Bing RSS无密钥，稳定 XML 源
mojeek无（或 MOJEEK_API_KEY）200/天Mojeek 独立索引非 Google/Bing 索引
serperSERPER_API_KEY2500/天Google高配额免费层
searchapiSEARCHAPI_API_KEY100/月Google / Bing多引擎
google_cseGOOGLE_API_KEY + GOOGLE_CX100/天Google官方 Google API
baiduBAIDU_API_KEY200/天Baidu最适合中文内容
wikipedia无1000/天Wikipedia事实/百科查询
searxng无无限（自托管）元搜索引擎（所有引擎）需要自己的实例
每日总配额（配置所有密钥）：8400+ 请求/天

凭证模型（重要）

  • 无强制 API 密钥 — DuckDuckGo + Bing RSS + Mojeek + Wikipedia 开箱即用。
  • 如果缺少密钥，需要 API 密钥的提供商会优雅失败（AuthError → 跳过，不消耗配额，无延迟）：
- BRAVE_API_KEY - EXA_API_KEY - TAVILY_API_KEY - SERPER_API_KEY - SEARCHAPI_API_KEY - GOOGLE_API_KEY + GOOGLE_CX - BAIDU_API_KEY - MOJEEK_API_KEY（可选 — 无密钥时使用 HTML 抓取）

核心功能

1. 搜索故障转移

默认提供商顺序： 
brave → exa → tavily → duckduckgo → bing_html → mojeek → serper → searchapi → google_cse → baidu → wikipedia
第一个成功的非空结果立即返回。

2. 任务级多查询搜索

  • 将一个目标扩展为多个针对性查询
  • 聚合 + 去重结果
  • 前缀预设：
- 默认：workers=1 - @dual ... → workers=2 - @deep ... → workers=3 + 更深的查询覆盖

3. 配额智能

  • 每提供商每日跟踪
  • 支持的提供商实时配额检索（Tavily、SearchAPI、Brave 通过探测）
  • 配额饱和度达到 80% 时自动减少并发

4. 提供商健康监控

  • 随时间跟踪每个提供商的成功率、延迟和错误类型
  • 计算健康分数（成功率 50%，延迟 30%，新鲜度 20%）
  • 智能排序：自动提升健康提供商，降级性能下降的提供商
  • 查看仪表板：python -m free_search health

5. 结果质量优化

  • 相关性评分（查询-标题-摘要 token 重叠）
  • 增强去重：URL + 标题相似度（Jaccard 阈值）
  • 域名多样性：限制同域名结果（默认最多 3 个）
  • 自动过滤低质量结果（短标题、缺失 URL）

6. 源自动发现

  • 探测所有配置的提供商的可用性
  • 扫描候选搜索引擎（Marginalia、Wiby、公共 SearXNG 实例）
  • 验证响应格式、延迟和结果质量
  • 生成新来源集成建议
  • 运行：python -m free_search discover

7. 托管持久化

  • memory/search-cache/YYYY-MM-DD/.json
  • memory/search-index/search-index.jsonl
  • memory/search-reports/YYYY-MM-DD/.md

快速命令

# 普通搜索
scripts/search "latest AI agent frameworks 2026" --max-results 5
# 任务搜索（多查询，并行）
scripts/search task "@dual Compare Claude vs GPT-4 for code generation" --max-results 5
# 深度研究模式
scripts/search task "@deep autonomous vehicle safety 2026" --max-results 8 --max-queries 10
# 配额状态
scripts/status
# 从提供商 API 获取实时配额
scripts/remaining --real
# 清理缓存
python3 -m free_search gc --cache-days 14
# 提供商健康仪表板
python3 -m free_search health
# 发现新搜索源
python3 -m free_search discover
# 系统诊断
python3 -m free_search doctor
# 设置状态和建议
python3 -m free_search setup

提供商设置指南

Bing RSS (bing_html) — 无需密钥

使用 Bing 内置的 RSS 端点（format=rss）— 绕过机器人检测。开箱即用。

Mojeek — 无需密钥（API 密钥可选）

开箱即用的 HTML 抓取。如需更高配额/稳定性：
  • 在 https://www.mojeek.com/services/search/api/ 注册
  • 设置 MOJEEK_API_KEY → 自动切换到 JSON API 模式

Wikipedia — 无需密钥

多语言支持 — 在 providers.yaml 中更改 lang： 
wikipedia:
  lang: it   # en | zh | it | de | fr | ja ...

Exa.ai — 需要 API 密钥

  • 在 https://exa.ai/ 注册
  • 设置 EXA_API_KEY
  • 免费层：1000 次搜索/月（约 33/天）

Google Custom Search — 需要 API 密钥 + CX

  • 获取 API 密钥：https://developers.google.com/custom-search/v1/introduction
  • 创建搜索引擎：https://programmablesearchengine.google.com/
  • 设置 GOOGLE_API_KEY 和 GOOGLE_CX
  • 免费层：100 次查询/天

Baidu Qianfan — 需要 API 密钥

  • 在 https://cloud.baidu.com/ 注册
  • 设置 BAIDU_API_KEY
  • 最适合中文内容

SearXNG — 需要自托管实例

公共实例对服务器到服务器请求有限速。使用自己的实例： 
docker run -d -p 8080:8080 searxng/searxng
然后在 providers.yaml 中： 
searxng:
  endpoint: http://localhost:8080
  enabled: true

安装后自检

# 1) 确认提供商加载
scripts/status --compact
# 2) 烟雾测试（开箱即用使用 duckduckgo/bing/mojeek）
scripts/search "openclaw" --max-results 3 --compact
# 3) 验证存储路径
ls -la /home/openclaw/.openclaw/workspace/memory/search-cache/ | tail -n 5
# 4) 检查实时配额（可选）
scripts/remaining --real --compact

输出契约（稳定）

  • 搜索：query, provider, results[], meta.attempted, meta.quota
  • 任务搜索：task, queries[], grouped_results[], merged_results[], meta
  • 配额：date, providers[], totals；使用 --real：real_quota.providers[]

运维注意事项

  • 默认模式：workers=1 — 为成本控制保守设置
  • 仅对研究任务使用 @dual / @deep
  • SearXNG 和 YaCy 默认 enabled: false（仅自托管）
  • MOJEEK_API_KEY 是可选的 — 提供商优雅回退到 HTML 抓取
  • 提供商健康数据存储在 memory/provider-health/health.jsonl
  • 发现结果存储在 memory/provider-discovery/discovery.jsonl
  • 设置后运行 python -m free_search doctor 验证一切正常
  • 定期运行 python -m free_search discover 查找新搜索源
数据来源：ClawHub ↗ · 中文优化：龙虾技能库