← Back to Skills Marketplace
98
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install web-searxng
Description
提供基于SearXNG的隐私保护搜索引擎，支持快速无追踪的网页搜索和结果聚合。
Usage Guidance
This skill implements what it says (a local SearXNG helper), but it performs active local discovery (runs 'docker ps' and probes localhost ports) and writes cache files. Critically, the script runs discovery at import time and will call sys.exit(1) if it doesn't find a SearXNG instance — that can terminate the agent process unexpectedly. Before installing: (1) don't enable this on shared or production machines; run in an isolated environment or container; (2) review and/or modify the script to remove import-time sys.exit and make discovery lazy; (3) ensure you want local Docker/port probing (it can reveal container names/ports); (4) install Python dependencies in a controlled virtualenv; (5) ask the author to add safer failure handling and an opt-in confirmation before probing Docker/ports. If you can't review or change the code, consider this risky and avoid enabling it system-wide.
Capability Assessment
Purpose & Capability
Name/description (SearXNG privacy search, auto-discovery, stock mode) align with the code and SKILL.md: the code queries a local SearXNG instance, can detect Docker containers and common ports, caches results, and performs result synthesis.
Instruction Scope
SKILL.md explicitly claims automatic Docker port discovery and local port probing, which the code implements. That behavior is within the stated purpose but is intrusive: the skill runs 'docker ps', scans localhost ports, and will write cache files under the skill directory. These actions access local system state beyond a simple HTTP client and may reveal container names/ports or interact with host tooling.
Install Mechanism
The skill is instruction-only with a bundled Python script and no install spec. It lists Python and several libraries as dependencies but does not install them automatically; installing will require the user's environment to provide Python 3.8+ and packages (aiohttp, aiofiles, httpx). This is not inherently malicious but increases friction and the chance of mistakes during manual setup.
Credentials
No credentials or sensitive environment variables are required. The script respects an optional SEARXNG_URL env var (declared in SKILL.md). It does not request unrelated secrets or external API tokens.
Persistence & Privilege
always is false and the skill does not request persistent platform-wide privileges, but the code writes a .cache directory next to the script (local disk write). More importantly, the module calls discovery at import time and calls sys.exit(1) if no local SearXNG is found — this can terminate the host process importing the module (agent), which is unsafe and unexpected behavior for a skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install web-searxng - After installation, invoke the skill by name or use
/web-searxng - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2 introduces smart mode detection and automatic Docker port discovery.
- Added automatic discovery of SearXNG Docker service ports.
- Introduced intelligent query mode detection: switches to stock analysis mode for finance-related queries, and uses standard search mode for others.
- Stock analysis mode outputs detailed reports with technical analysis and recommendations.
- Enhanced search output formatting for both modes.
- Improved reliability by checking environment variables, running containers, and common ports for service connectivity.
v1.0.1
- Major cleanup: removed 12 obsolete files, including previous .cache and the old searxng.py.
- Added new main script at scripts/searxng.py to streamline the codebase.
- Updated documentation to clarify usage scenarios and highlight enhanced privacy capabilities.
v1.0.0
Initial release – searxng skill version 1.0.0
- Added core files to enable private, local SearXNG-powered web search.
- Removed legacy documentation and script files.
- Now all internet search tasks are handled exclusively via searxng (web_search is forbidden).
- Provides fast, privacy-respecting query functionality with category and advanced options support.
Metadata
Frequently Asked Questions
What is web-searxng?
提供基于SearXNG的隐私保护搜索引擎，支持快速无追踪的网页搜索和结果聚合。 It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.
How do I install web-searxng?
Run "/install web-searxng" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is web-searxng free?
Yes, web-searxng is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does web-searxng support?
web-searxng is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created web-searxng?
It is built and maintained by xumanzi (@xumanzi); the current version is v1.0.2.
More Skills