{"skill":{"slug":"searxng-docker","displayName":"SearXNG Docker","summary":"Search the web using a local SearXNG instance (privacy-respecting metasearch engine). Use when user asks to search, look something up, \"搜索\", \"搜一下\", \"查一下\", or...","description":"---\nname: searxng\ndescription: Search the web using a local SearXNG instance (privacy-respecting metasearch engine). Use when user asks to search, look something up, \"搜索\", \"搜一下\", \"查一下\", or when web_search returns poor results. Supports categories (news, images, videos, IT, science), time filters, language, and multiple engines (Google, Bing, DuckDuckGo, etc.). No API key needed — fully self-hosted.\n---\n\n# SearXNG Search Skill\n\nSearch the web using a self-hosted SearXNG instance.\n\n## When to Use\n\n- User asks to search, look something up: \"搜索\", \"搜一下\", \"查一下\", \"search for\", \"look up\"\n- Need results from multiple engines (Google, Bing, DuckDuckGo, etc.)\n- Need news, images, IT/science, or social media search\n- `web_search` unavailable or returns poor results\n\n## Deployment\n\n### Quick Start (Docker Compose)\n\nThe `docker/` folder in this skill contains a ready-to-use Docker Compose setup. Run it directly — no need to copy files elsewhere.\n\n```bash\n# 1. Generate a random secret key\nsed -i \"s/CHANGE_ME_TO_A_RANDOM_STRING/$(openssl rand -hex 16)/\" docker/settings.yml\n\n# 2. Start\ndocker compose -f docker/docker-compose.yml up -d\n\n# 3. Verify\ncurl -s \"http://127.0.0.1:8888/search?q=test&format=json\" | python3 -m json.tool | head -5\n```\n\n### Configuration\n\nEdit files in the `docker/` folder:\n\n- **Port**: Default `127.0.0.1:8888` → change in `docker-compose.yml` ports section\n- **Engines**: Edit `settings.yml` engines list (Google, Bing, DuckDuckGo, Wikipedia, GitHub enabled by default)\n- **Language**: `default_lang` in `settings.yml` (default: `auto`)\n\n### Troubleshooting\n\n```bash\n# Check if running\ndocker ps | grep searxng\n\n# Restart\ndocker compose -f docker/docker-compose.yml restart\n\n# View logs\ndocker logs searxng --tail 50\n```\n\n## Usage\n\nAll commands use the script at `scripts/searxng_search.py` (relative to this skill directory). The script defaults to `http://127.0.0.1:8888` but accepts `--base-url` to point elsewhere.\n\n```bash\n# Basic search\npython3 scripts/searxng_search.py \"your query\"\n\n# Number of results\npython3 scripts/searxng_search.py \"your query\" -n 5\n\n# Language\npython3 scripts/searxng_search.py \"your query\" -l zh    # Chinese\npython3 scripts/searxng_search.py \"your query\" -l en    # English\n\n# Category\npython3 scripts/searxng_search.py \"your query\" -c news\npython3 scripts/searxng_search.py \"your query\" -c images\npython3 scripts/searxng_search.py \"your query\" -c it\npython3 scripts/searxng_search.py \"your query\" -c science\n\n# Time filter\npython3 scripts/searxng_search.py \"your query\" -t day\npython3 scripts/searxng_search.py \"your query\" -t week\npython3 scripts/searxng_search.py \"your query\" -t month\n\n# Specific engines\npython3 scripts/searxng_search.py \"your query\" -e google,bing\n\n# JSON output\npython3 scripts/searxng_search.py \"your query\" --json\n\n# Custom SearXNG URL\npython3 scripts/searxng_search.py \"your query\" --base-url http://192.168.1.100:8888\n\n# Combined\npython3 scripts/searxng_search.py \"最新科技新闻\" -c news -l zh -t week -n 5\n```\n\n## Categories\n\n| Category | Description |\n|----------|-------------|\n| `general` | Web search (default) |\n| `news` | News articles |\n| `images` | Image search |\n| `videos` | Video search |\n| `it` | IT / programming |\n| `science` | Scientific articles |\n| `files` | File search |\n| `social media` | Social media posts |\n\n## Notes\n\n- SearXNG aggregates and deduplicates results from multiple engines\n- The `score` field indicates cross-engine ranking confidence\n- No API key needed — fully self-hosted and private\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":898,"installsAllTime":2,"installsCurrent":2,"stars":0,"versions":1},"createdAt":1772122118729,"updatedAt":1778993463340},"latestVersion":{"version":"1.0.0","createdAt":1772122118729,"changelog":"Initial release: self-hosted SearXNG search with Docker Compose setup and Python search script","license":null},"metadata":null,"owner":{"handle":"triwinds","userId":"s17dpxt1k5e2274jm6w6kw5vqx884txg","displayName":"triwinds","image":"https://avatars.githubusercontent.com/u/7413161?v=4"},"moderation":null}