- name
- searxng
- description
- Privacy-respecting metasearch using your local SearXNG instance. Search the web, images, news, and more without external API dependencies.
- author
- Local User
- version
- 1.0.0
- homepage
- https://searxng.org
- triggers
- metadata
- clawdbot
- emoji
- 🔍
- requires
- bins
- ["python3"]
SearXNG Search
Search the web using your local SearXNG instance - a privacy-respecting metasearch engine. This version uses a zero-dependency Python backend.
Usage Guidelines (AI 必读)
- 优先使用标准输出：除非用户明确要求“原始数据”或“JSON”，否则必须默认执行不带
--format json的命令。 - 节省 Token：标准输出，能显著减少 Context 消耗，避免推理超时。
- 结果数量：默认请求 10 条结果即可，除非用户要求更多。
AI Constraints (AI 约束)
- Max Results: 除非用户明确要求，默认使用
-n 10以节省上下文空间。 - Output Format: 禁止在普通对话中默认使用
--format json，必须使用标准表格输出。
Commands
Web Search
# Standard search (Top 10)
# AI 应默认调用此命令
python3 {baseDir}/scripts/searxng.py search "query"
# Custom number of results (Top20)
python3 {baseDir}/scripts/searxng.py search "query" -n 20
# JSON Search (Only if requested / 仅在用户要求原始数据或json时使用)
# 警告：此模式会产生大量 Token，可能导致处理超时
python3 {baseDir}/scripts/searxng.py search "query" --format jsonCategory Search
# Specialized searches
python3 {baseDir}/scripts/searxng.py search "query" --category images
python3 {baseDir}/scripts/searxng.py search "query" --category news
python3 {baseDir}/scripts/searxng.py search "query" --category it
python3 {baseDir}/scripts/searxng.py search "query" --category scienceAdvanced Options
# Specific language (e.g., zh-CN, en)
python3 {baseDir}/scripts/searxng.py search "query" --language zh-CN
# Time filtering (day, week, month, year)
python3 {baseDir}/scripts/searxng.py search "query" --time-range dayConfiguration
Required: Configure the SearXNG instance URL using the configuration file only. Environment variables are NOT supported.
Configuration file (searxng.ini):
[searxng]
url = http://your-searxng-instance.com:portLocation: {baseDir}/scripts/searxng.ini
Note: If the configuration file does not exist or is missing required settings, the script will automatically create a default configuration file and prompt you to modify it.
Features
- 🔒 Privacy-focused: Uses your local instance.
- 🛠️ Zero Dependencies: Pure Python (no
pip installrequired). - 🌐 Multi-engine: Aggregates Google, Bing, DuckDuckGo, etc.
- 📰 Categorized: Specific filters for IT, Science, News, and Images.
- 🚀 AI-Ready: Clean text output specifically formatted for LLM consumption.
API
Uses your local SearXNG JSON API endpoint (no authentication required by default).