searxng

# 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 必读) 1. **优先使用标准输出**：除非用户明确要求“原始数据”或“JSON”，否则**必须**默认执行不带 `--format json` 的命令。 2. **节省 Token**：标准输出，能显著减少 Context 消耗，避免推理超时。 3. **结果数量**：默认请求 10 条结果即可，除非用户要求更多。 ## AI Constraints (AI 约束) - **Max Results**: 除非用户明确要求，默认使用 `-n 10` 以节省上下文空间。 - **Output Format**: **禁止**在普通对话中默认使用 `--format json`，必须使用标准表格输出。 ## Commands ### Web Search ```bash # 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 json ``` ### Category Search ```bash # 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 science ``` ### Advanced Options ```bash # 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 day ``` ## Configuration **Required:** Configure the SearXNG instance URL using the configuration file **only**. Environment variables are NOT supported. **Configuration file** (`searxng.ini`): ```ini [searxng] url = http://your-searxng-instance.com:port ``` Location: `{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 install` required). - 🌐 **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).