private-web-search-searchxng
by adelpro
Web & Frontend DevelopmentBrief
Self-hosted private web search using SearXNG.
Description
What This Skill Does
Runs a SearXNG instance locally via Docker to perform web searches without sending queries to third-party APIs. Aggregates results from Google, Bing, DuckDuckGo, Brave, and others through a single JSON endpoint. No account or API key required after setup.
Unlike paid search APIs, SearXNG is free after setup, logs nothing, and queries multiple engines simultaneously from one endpoint.
When to Use It
- Searching the web privately without query logging
- Running AI agent search in API-restricted or air-gapped environments
- Replacing paid search APIs with a free self-hosted alternative
- Aggregating results from multiple search engines in one request
- Prototyping search-enabled agents without usage limits or rate caps
Example Workflow
User asks: search for 'openclaw ai agent framework' and return the top 5 results
- 1
Verify the SearXNG container is running with docker start searxng
- 2
Send GET request to http://localhost:8080/search?q=openclaw+ai+agent+framework&format=json
- 3
Parse the JSON response and extract .results[:5]
- 4
Return titles, URLs, and content snippets to the user
List of 5 search results with title, URL, and snippet for each
Requirements
- Docker installed and running on the host machine
Installation
clawhub install adelpro/private-web-search-searchxngRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.