SearXNG 网页搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-searxng-web-search。
技能介绍
模型知识边界之外还要查证什么
大模型的训练数据有截止时间,也无法替你访问刚发布的公告、变更后的 API 文档或社媒上的讨论。你若要在对话里引用当前事实、最新新闻或可点击的出处,就需要一条可控的网页检索通路,而不是依赖内置搜索或不可审计的第三方聚合。
技能如何工作
本技能面向你自托管的 SearXNG 实例,通过其 JSON API 发起查询并返回已格式化的文本结果。核心行为包括:
- 用环境变量
SEARXNG_URL指向实例(未设置时默认http://localhost:8888) - 执行搜索脚本传入查询词,并可附加 JSON 参数:
category(如news、it、science)、time_range(day/week/month/year)、language、num_results等 - 限速:请求间隔至少 1 秒,用文件系统状态(
.searxng-last-request)避免误刷 - 错误处理:30 秒超时、实例不可用、无效查询、429 限流、空结果均有明确提示
实现上搜索脚本(scripts/search.clj)用 babashka HTTP 客户端与 Cheshire 解析 JSON,并对结果做评分排序,优先展示更相关条目。更细的 API 说明见技能内 references/api-guide.md。
适用边界与注意点
- 你必须先有可用的 SearXNG 服务;连接失败、超时或空结果需从实例状态、防火墙、
curl探测及日志(如journalctl -u searx)侧排查。 - 检索质量取决于 SearXNG 配置与上游引擎,技能只负责调用与格式化,不保证某一引擎永远有结果。
- 连续高频搜索仍会受实例与脚本侧限速约束,不宜当作无限制爬虫使用。
使用场景
- 写发布说明前,用 news 分类检索过去一周某开源项目的安全公告原文链接
- 调试集成问题时,按 it 分类查找厂商刚更新的 REST 文档与状态页说明
- 核对媒体报道中的数据时,用 time_range=day 拉取当日检索结果并与模型记忆对照
- 给同事推荐示例代码前,用 general 搜索特定库的实现片段并附带可访问 URL
适合人员
- 在内网部署 SearXNG、希望助手只走自家检索出口的隐私敏感团队工程师
- 维护开源技能清单、需要定期验证外部链接是否仍有效的文档维护者
- 写技术调研结论、必须把引用限定在可复核网页出处的研究员或架构师
- 负责 on-call 排障、需要快速查当前服务状态与公告而非依赖旧训练数据的 SRE