private-web-search-searchxng
Self-hosted private web search using SearXNG. Use when privacy is important, external search APIs are blocked or paid, or you need search without tracking. Skill: private-web-search-searchxng Owner: adelpro Summary: Self-hosted private web search using SearXNG. Use when privacy is important, external search APIs are blocked or paid, or you need search without tracking. Tags: latest:1.3.2 Version history: v1.3.2 | 2026-08-20T21:43:12.511Z | auto - Updated version to 1.3.2. - Documentation updates in README.md and SKILL.md, with minor text and formatting changes. - Remove
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
1.3.2
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.7K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.3.2release · observed Aug 20, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s177vajy8ffpjnym8evc1jcxr5877x59:private-web-search-searchxng- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-adelpro-private-web-search-searchxng/snapshot"
Documentation
CLAWHUB
26,782 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: private-web-search-searchxng
slug: private-web-search-searchxng
version: 1.3.2
description: |
Self-hosted private web search using SearXNG. Use when privacy is important, external search APIs are blocked or paid, or you need search without tracking.
triggers:
- private search
- searxng
- self hosted search
- privacy search
- search without tracking
metadata:
openclaw:
requires:
bins: ["docker", "curl", "jq"]
env: []
---
# Private Web Search (SearXNG)
Privacy-respecting, self-hosted metasearch engine for AI agents.
## Quick Setup
```bash
# If container exists but stopped:
docker start searxng
# Or fresh start:
docker run -d --name searxng -p 8080:8080 -e BASE_URL=http://localhost:8080/ --restart unless-stopped searxng/searxng
# Enable JSON API (only needed once)
docker exec searxng sed -i 's/ formats:/ formats:\n - json/' /etc/searxng/settings.yml
docker restart searxng
# Verify
curl -s "http://localhost:8080/search?q=test&format=json&engines=bing&num_results=1" | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"Results: {d.get('number_of_results',0)}\")"
## Usage
### Basic Search
```bash
curl -sL "http://localhost:8080/search?q=YOUR_QUERY&format=json" | jq '.results[:10]'
```
### Using the Helper Script
```bash
./scripts/search.sh "openclaw ai" 5
```
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| SEARXNG_PORT | 8080 | Container port |
| SEARXNG_HOST | localhost | Server host |
| BASE_URL | http://localhost:8080 | Public URL |
## Working Engines (Tested June 2026)
**85 engines enabled** by default, but most major engines are blocked or rate-limited:
| Engine | Status | Results | Notes |
|--------|--------|---------|-------|
| Bing | Working | 10-30 | Most reliable, 282K+ total |
| GitHub | Working | 30 | Package/repo search |
| Stack Overflow | Working | 10 | Q&A search |
| Wikipedia | Sometimes | 1 | Varies by query |
| Google | Blocked | 0 | CAPTCHA, "access denied" |
| DuckDuckGo | Blocked | 0 | Rate limited |
| Startpage | Blocked | 0 | CAPTCHA |
| Qwant | Blocked | 0 | Rate limited |
### Multi-Engine Queries (Recommended)
Combine multiple working engines for best results:
```bash
# Get combined results from Bing + GitHub + Stack Overflow
curl -s "http://localhost:8080/search?q=python&format=json&engines=bing,github,stackoverflow&num_results=10"
```
This returns 40+ results with diverse sources (web, code, Q&A).
### Why Most Engines Fail
- **Google/DuckDuckGo**: Detect automated traffic, return CAPTCHA/403 errors
- **Public instances**: Get IP-banned quickly due to high volume
- **Self-hosted**: Slightly better but still rate-limited
- **Bing**: Most permissive, works reliably
**Note:** Engine status changes frequently. Test with `&num_results=5` to verify before heavy use.
## Management
```bash
docker start searxng # Start
docker stop searxng # Stop
docker logs searxng # View logs
docker rm searxngREADME.md
# private-web-search-searchxng > Self-hosted private web search using SearXNG — privacy-respecting metasearch for AI agents, no tracking, no paid APIs. [](https://clawhub.ai) []() []() Run your own SearXNG instance and get JSON search results from Bing, GitHub, Stack Overflow and more — without leaking queries to commercial search/tracking APIs. ## Install ### Via pipeline (GitHub → npx skills) ```bash npx skills add adelpro/private-web-search-searchxng ``` ### Manual ```bash cp -r private-web-search-searchxng ~/.hermes/skills/ ``` ## Setup (SearXNG container) ```bash # Start (or restart a stopped container) docker start searxng # Or fresh start docker run -d --name searxng -p 8080:8080 -e BASE_URL=http://localhost:8080/ --restart unless-stopped searxng/searxng # Enable JSON API (only needed once) docker exec searxng sed -i 's/ formats:/ formats:\n - json/' /etc/searxng/settings.yml docker restart searxng ``` ## Usage ```bash # Recommended: combined engines (Bing + GitHub + Stack Overflow) curl -s "http://localhost:8080/search?q=python&format=json&engines=bing,github,stackoverflow&num_results=10" # Helper script ./scripts/search.sh "your query" 5 ``` ### Environment variables - `SEARXNG_PORT` (8080) — container port - `SEARXNG_HOST` (localhost) — server host - `SEARXNG_FORMAT` (json) — response format SearXNG enables 85 engines by default but most are rate-limited/blocked. Bing is the most reliable; Google, DuckDuckGo and Startpage are typically blocked (CAPTCHA/403). Engine status changes often — test with `num_results=5` before heavy use. ## Requirements - Node.js 18+ (helper script uses curl + jq) - Docker (for the SearXNG container) - curl, jq ## Related Skills - **web-search** — General web search - **search-cluster** — Aggregated Google/Wikipedia/Reddit search ## Credits SearXNG is a free, privacy-respecting metasearch engine. No OpenClaw branding implied — this is a generic agent skill.
_meta.json
{
"ownerId": "kn72cbvk9f5n48msm4t4sj3wyh80n2eb",
"slug": "private-web-search-searchxng",
"version": "1.3.2",
"publishedAt": 1787262192511
}skill-card.md
## Description: Self-hosted private web search using SearXNG for privacy-sensitive searches when external search APIs are blocked, paid, or undesirable. This skill is ready for commercial/non-commercial use. ## Publisher: [adelpro](https://clawhub.ai/user/adelpro) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agent builders use this skill to run a local SearXNG service and retrieve JSON web search results through curl, jq, or the helper script without relying on paid search APIs. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The setup uses an unpinned persistent SearXNG Docker image and exposes the service on port 8080. Mitigation: Pin the SearXNG image by digest, bind the service to 127.0.0.1, and review container settings before deployment. Risk: Installation and setup commands include npx and Docker operations that can change the local environment. Mitigation: Run installation and Docker commands with least privilege and review the artifact before execution. Risk: The helper script has weak handling for its result-limit argument. Mitigation: Treat the limit as numeric-only and validate it before use until the helper script is fixed. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/adelpro/skills/private-web-search-searchxng) - [README](artifact/README.md) - [Skill Definition](artifact/SKILL.md) ## Skill Output: **Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance] **Output Format:** [Markdown with bash commands and JSON search-result examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires Docker, curl, and jq; queries a local SearXNG endpoint.] ## Skill Version(s): 1.3.2 (source: frontmatter and server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/adelpro/skills/private-web-search-searchxng",
"sourceUrl": "https://clawhub.ai/adelpro/skills/private-web-search-searchxng",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:08:45.400Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-adelpro-private-web-search-searchxng/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-adelpro-private-web-search-searchxng/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T05:08:45.400Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceUrl": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:08:45.400Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.2",
"href": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceUrl": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-20T21:43:12.511Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-adelpro-private-web-search-searchxng/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-adelpro-private-web-search-searchxng/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.2",
"description": "- Updated version to 1.3.2. - Documentation updates in README.md and SKILL.md, with minor text and formatting changes. - Removed the file skill-card.md.",
"href": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceUrl": "https://clawhub.ai/adelpro/private-web-search-searchxng",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-20T21:43:12.511Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
