← Back to Skills Marketplace
720
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install local-websearch-1
Description
Search the web using a self-hosted SearXNG metasearch engine aggregating multiple sources without API keys and returning JSON results.
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 {baseDir}/scripts/searxng_search.py "your query"
python3 {baseDir}/scripts/searxng_search.py "query" --count 10
python3 {baseDir}/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's code appears to implement a straightforward SearXNG client, but the package metadata and runtime instructions are inconsistent. Before installing: (1) confirm the author fixes metadata (declare SEARXNG_URL and python3 as requirements and correct the command path to where the script actually lives), (2) verify the owner/slug in _meta.json matches the registry entry, and (3) only point SEARXNG_URL at a SearXNG instance you control or trust — the agent will send every search query there, so a malicious or public endpoint could receive private queries. If you cannot verify these fixes, treat the skill as untrusted.
Capability Analysis
Type: OpenClaw Skill
Name: local-websearch-1
Version: 1.0.0
The skill is designed to perform web searches via a self-hosted SearXNG instance. The `SKILL.md` provides clear, benign instructions for the AI agent and the user, with no evidence of prompt injection attempts. The `searxng_search.py` script correctly implements the stated functionality, using standard Python libraries for network communication and argument parsing. It relies on a user-configured `SEARXNG_URL` environment variable and handles input safely, preventing common injection vulnerabilities. There is no evidence of intentional harmful behavior, data exfiltration, persistence, or unauthorized execution.
Capability Assessment
Purpose & Capability
The skill claims no required env vars or binaries in the registry metadata, but the SKILL.md metadata and the script require SEARXNG_URL and python3. Also the registry slug/ownerId differ from _meta.json values. These mismatches mean the declared purpose (local SearXNG search) is fine, but the declared requirements are incomplete/inconsistent.
Instruction Scope
SKILL.md and the included Python script stay within the stated purpose: they only call the user-provided SearXNG instance and return JSON. The script does not read arbitrary host files or access other credentials. However, the SKILL.md's command points to scripts/searxng_search.py while the provided file is searxng_search.py at the repository root — a runtime path mismatch that will break execution.
Install Mechanism
There is no install spec (instruction-only with an included script). No external downloads or package installs are requested, which is low risk. The script is plain Python and does simple HTTP requests.
Credentials
The only environment requirement needed by the script is SEARXNG_URL (and python3). Those are appropriate for a self-hosted SearXNG client, but the registry metadata does not declare them. That omission is a red flag because users won't be informed that the agent will send queries to whatever URL is set — which could be a remote endpoint of unknown trustworthiness.
Persistence & Privilege
No elevated persistence is requested. always is false and the skill does not modify other skills or system configuration. Autonomous invocation is enabled by default but is not combined with broad credentials or persistence here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install local-websearch-1 - After installation, invoke the skill by name or use
/local-websearch-1 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the searxng skill for private, web-based search with a self-hosted SearXNG instance.
- Supports aggregation of multiple search engines (Google, Brave, DuckDuckGo, etc.) without API keys.
- Provides command-line usage with options for result count and language selection.
- Outputs structured JSON including query, results, source engines, and relevance scores.
- Requires setting the SEARXNG_URL environment variable for configuration.
Metadata
Frequently Asked Questions
What is Local Websearch 1?
Search the web using a self-hosted SearXNG metasearch engine aggregating multiple sources without API keys and returning JSON results. It is an AI Agent Skill for Claude Code / OpenClaw, with 720 downloads so far.
How do I install Local Websearch 1?
Run "/install local-websearch-1" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Local Websearch 1 free?
Yes, Local Websearch 1 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Local Websearch 1 support?
Local Websearch 1 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Local Websearch 1?
It is built and maintained by eg-yks (@eg-yks); the current version is v1.0.0.
More Skills