用途:search-cluster 是一款统一的多源搜索聚合系统,用于从多个来源并行收集信息。它整合 Google、Wikipedia、Reddit、NewsAPI 以及标准 RSS/Atom 订阅源,适合需要跨源检索、快速汇总信息的场景。
主要能力:支持针对单一来源的定向搜索,也支持一次性查询所有已支持引擎并聚合结果;可抓取并解析标准 RSS 或 Atom 订阅源;可选启用 Redis 缓存以提升重复查询效率。
使用方式:需先安装 python3。Google 搜索需配置 GOOGLE_CSE_KEY 与 GOOGLE_CSE_ID,NewsAPI 需配置 NEWSAPI_KEY,可在环境变量或本地 .env 文件中定义。可选缓存需可用的 Redis 实例(默认 localhost:6379),并安装客户端:pip install redis。
命令示例:单源搜索使用 python3 $WORKSPACE/skills/search-cluster/scripts/search-cluster.py <source> "<query>",来源可选 google、wiki、reddit、newsapi;聚合搜索使用 python3 $WORKSPACE/skills/search-cluster/scripts/search-cluster.py all "<query>";RSS 抓取使用 python3 $WORKSPACE/skills/search-cluster/scripts/search-cluster.py rss "<url>"。
限制与安全:所有 API 与订阅源请求强制启用严格的 SSL/TLS 校验,不提供未校验的回退方案;缓存键以 search: 为前缀避免命名冲突;Redis 默认连接 localhost,远程实例需显式设置 REDIS_HOST;请求使用统一的 SearchClusterBot 用户代理以符合站点策略。具体 API 配置可参阅 references/search-apis.md。