← Back to Skills Marketplace
3240
Downloads
1
Stars
12
Active Installs
1
Versions
Install in OpenClaw
/install local-websearch
Description
Search the web using a self-hosted SearXNG metasearch engine. Aggregates Google, Brave, DuckDuckGo, and more without API keys.
README (SKILL.md)
SearXNG Web Search
Privacy-respecting metasearch via your self-hosted SearXNG instance.
When to use (trigger phrases)
Use this skill when the user asks:
- "search the web for..."
- "look up..." / "find information about..."
- "what is..." (when current info needed)
- "research..." / "search for..."
- "google..." (redirect to privacy-respecting search)
Quick start
python3 ~/.clawdbot/skills/searxng/scripts/searxng_search.py "your query"
python3 ~/.clawdbot/skills/searxng/scripts/searxng_search.py "query" --count 10
python3 ~/.clawdbot/skills/searxng/scripts/searxng_search.py "query" --lang de
Setup
Set SEARXNG_URL environment variable:
export SEARXNG_URL="http://your-searxng-host:8888"
Flags
| Flag | Default | Description |
|---|---|---|
-n, --count |
5 | Results to return (1-20) |
-l, --lang |
auto | Language code (en, de, fr, es, etc.) |
Output
Returns JSON:
{
"query": "search terms",
"count": 5,
"results": [
{"title": "...", "url": "...", "description": "...", "engines": ["google", "brave"], "score": 1.5}
]
}
Notes
- No API keys needed—SearXNG aggregates upstream engines
- Results include source engines for transparency
- Scores indicate relevance (higher = better)
- For news, add "news" to query or use
--langfor regional results
Usage Guidance
This skill appears to be a simple, honest client for a self-hosted SearXNG instance and the Python code looks benign (it only calls the URL you provide). Before installing: 1) Verify and correct the metadata mismatch — the registry should declare python3 and SEARXNG_URL so prompts/permissions are clear. 2) Confirm which file path will be executed (manifest vs quick-start path). 3) Only set SEARXNG_URL to a trusted endpoint (prefer HTTPS) — the skill will send your queries to that URL and the instance will see them. 4) If you plan to let the agent call this autonomously, consider network controls or allowlisting the SearXNG host to reduce risk. If you want higher assurance, run the script locally yourself first or inspect and run it in an isolated environment.
Capability Analysis
Type: OpenClaw Skill
Name: local-websearch
Version: 1.0.0
The skill is designed to perform web searches using a self-hosted SearXNG instance. The Python script (`searxng_search.py`) correctly implements this by reading the user-defined `SEARXNG_URL` environment variable and making HTTP requests to it. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts in the `SKILL.md` or code. All actions are aligned with the stated purpose of providing a privacy-respecting web search.
Capability Assessment
Purpose & Capability
The skill's stated purpose (use a self-hosted SearXNG instance) matches the actual code: the Python script queries a provided SEARXNG_URL and returns JSON results. However, the registry metadata in the package summary claimed no required environment variables or binaries, while SKILL.md metadata and the script require python3 and the SEARXNG_URL environment variable. That metadata mismatch is unexpected and reduces confidence in packaging/maintenance.
Instruction Scope
SKILL.md instructions are narrowly scoped: they tell the agent/user to set SEARXNG_URL and run the provided Python script. The script only performs HTTP requests to the SEARXNG_URL and does not read other files, credentials, or system state. Minor inconsistency: quick-start examples reference a scripts/ path (~/.clawdbot/skills/searxng/scripts/searxng_search.py) while the manifest shows searxng_search.py at top level.
Install Mechanism
There is no install spec (instruction-only / bundled script). Nothing is downloaded or extracted at install time, which reduces install-time risk.
Credentials
The script expects a single environment variable, SEARXNG_URL, which is appropriate for its purpose. The concern is the registry metadata omission: the skill package does not declare this required env/binary in the registry summary, so automated install flows or permission prompts might not surface the need for this sensitive endpoint URL.
Persistence & Privilege
The skill does not request persistent privileges, does not set always:true, and does not modify other skills or system configuration. It runs only when invoked and performs network requests to the configured SearXNG instance.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install local-websearch - After installation, invoke the skill by name or use
/local-websearch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Local web search using SearXNG?
Search the web using a self-hosted SearXNG metasearch engine. Aggregates Google, Brave, DuckDuckGo, and more without API keys. It is an AI Agent Skill for Claude Code / OpenClaw, with 3240 downloads so far.
How do I install Local web search using SearXNG?
Run "/install local-websearch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Local web search using SearXNG free?
Yes, Local web search using SearXNG is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Local web search using SearXNG support?
Local web search using SearXNG is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Local web search using SearXNG?
It is built and maintained by stperic (@stperic); the current version is v1.0.0.
More Skills