← Back to Skills Marketplace
376
Downloads
0
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install local-search-pro
Description
Free Brave API alternative for OpenClaw. Completely FREE web search. No API key required. Secure localhost-only deployment. Supports hidden --dev flag for lo...
README (SKILL.md)
💰 Free & Secure Brave API Alternative
local-search-pro provides a 100% FREE and secure replacement for OpenClaw's built-in web_search.
Python Dependency
The runtime scripts require the Python package requests.
Install if missing:
pip install requests
✅ No Brave API key
✅ No $5/month cost
✅ Localhost-only deployment
✅ Limiter enabled
✅ Safe search enabled
Dev Mode
Advanced users can run:
python scripts/install.py --dev
⚠ Dev mode disables:
- safe_search (set to 0)
- limiter (disabled)
This weakens safety protections and is intended for local development only.
Persistence Notice
⚠ The install script runs Docker with --restart unless-stopped and -d, which creates a persistent background container (searxng-local).
- The container will continue running after OpenClaw exits.
- It will automatically restart on system reboot.
- This is intentional for local service stability.
To remove the service:
docker rm -f searxng-local
Users should be aware this is a system-level persistent service.
Security Model
- Docker container binds to 127.0.0.1 only
- Request limiter enabled by default
- Safe search enabled by default
- No public exposure
- No global config modifications
This skill does not modify global OpenClaw configuration.
Usage Guidance
This skill appears to do what it claims (deploy a local SearxNG instance and call it). Before installing: (1) Understand it will create a detached Docker container named searxng-local that restarts on reboot — remove it with 'docker rm -f searxng-local' when done. (2) The install will pull the searxng/searxng image from Docker Hub; inspect the image or its source if you need higher assurance. (3) The settings include a hard-coded secret_key; consider editing searxng/settings.yml to a unique secret before starting. (4) Avoid using --dev on any machine you care about (it disables safe_search and rate limiting). (5) The container is mapped to host 127.0.0.1:8080; ensure your Docker host/network settings don't inadvertently expose that port. If you need higher confidence, review the upstream searxng image and run the container in a constrained environment (limited privileges, user namespaces) or inspect the image contents before first run.
Capability Analysis
Type: OpenClaw Skill
Name: local-search-pro
Version: 1.0.10
The skill automates the deployment of a persistent SearXNG service via Docker, using the `--restart unless-stopped` flag in `scripts/install.py` to ensure the container persists across system reboots. While this behavior is documented in `SKILL.md` and aligned with the stated goal of providing a local search API, the creation of a persistent system-level service and the use of `subprocess.run(shell=True)` are high-risk behaviors. The skill correctly binds the service to `127.0.0.1` and uses the official `searxng/searxng` image, with no evidence of data exfiltration or intentional malice detected.
Capability Assessment
Purpose & Capability
Name/description (local SearxNG-based search proxy) align with the included scripts and settings. Required binaries (docker, python3) are appropriate for running the provided install and runtime scripts. The skill does not request unrelated credentials or services.
Instruction Scope
SKILL.md and the scripts limit network interactions to the local SearxNG instance. The install script writes a settings.yml and runs docker run; search and healthcheck call the local HTTP endpoints. One nuance: the settings inside the container bind to 0.0.0.0 while the docker command maps the container port to host 127.0.0.1:8080 — this effectively restricts exposure to localhost but is a subtle detail (the README claims 'container binds to 127.0.0.1 only'). Dev mode intentionally disables limiter and safe_search (documented), which weakens safety and should only be used locally.
Install Mechanism
There is no packaged install spec; the included install.py calls 'docker run searxng/searxng', which will pull the image from Docker Hub at runtime. Pulling an image from a public registry is expected here but carries the usual trust risk: users should verify the image origin and contents before running.
Credentials
No credentials or external environment variables are required. The code optionally respects SEARXNG_BASE_URL (not listed as required), which is reasonable. One minor issue: a fixed secret_key is written into settings.yml (local_search_pro_secure_2026) — this is not a requested credential, but it is a hard-coded secret that users may wish to change for better security.
Persistence & Privilege
The install script runs the container detached with '--restart unless-stopped', creating a persistent background service that restarts on reboot. The SKILL.md explicitly warns about this. 'always: false' is used; the skill does not auto-enable itself across all agents, but the persistent container is a system-level artifact and requires user consent.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install local-search-pro - After installation, invoke the skill by name or use
/local-search-pro - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.10
Mark SEARXNG_BASE_URL as optional (remove required env). Declare Python dependency: requests.
v1.0.9
Add persistence notice (Docker container runs with --restart unless-stopped). Clarify uninstall procedure.
v1.0.8
Declare SEARXNG_BASE_URL env var and clarify dev mode safety impact (safe_search + limiter disabled).
v1.0.7
Declare required binaries (docker, python3) in metadata. Improve registry accuracy.
v1.0.6
Fix SearXNG 2026 compatibility (secret_key + json format support). Improve secure localhost deployment.
v1.0.5
- Added hidden --dev flag to install script for local development, disabling limiter and safe_search.
- Updated documentation to reflect --dev flag usage and new development mode.
- Minor description updates for clarity.
v1.0.4
local-search-pro v1.0.4
- Enforces secure, localhost-only SearXNG deployment with no public exposure.
- Adds request limiter and enables safe search by default.
- Updates documentation to highlight security model and stricter privacy.
- Refines skill description and keywords for accuracy and clarity.
v1.0.3
- Updated description to clarify use as a free, self-hosted Brave API alternative for OpenClaw.
- Expanded keyword list for improved discoverability.
- Improved and reorganized documentation for clarity, highlighting main use cases (e.g., news search, OpenAI/model lookup).
- Refined language for easier onboarding and feature explanation.
- No functional code or configuration changes.
v1.0.2
**Improved clarity and readability of SKILL.md documentation**
- Updated description and keywords to emphasize cost savings, ease of setup, and integration with OpenClaw.
- Added clearer comparison with built-in web_search and highlighted 100% free usage.
- Improved formatting with sections and checkmarks for benefits and features.
- Provided more concise quick start instructions and usage details.
- Reorganized content for easier reference and understanding.
v1.0.1
- Updated description to emphasize the skill is completely free and requires no Brave API key or monthly fee.
- Highlighted benefits as a zero-cost, self-hosted alternative to Brave API web search.
- Added keywords to metadata for improved searchability.
- Expanded "Why Use This Skill?" section for clearer user value.
- No changes to features, usage instructions, or technical setup.
v1.0.0
- Initial release of local-search-pro skill
- Enables web searching via a local SearXNG instance (default: http://127.0.0.1:8080)
- Supports SEARXNG_BASE_URL environment variable for custom configuration
- Includes install and healthcheck scripts for setup and monitoring
- Handles errors gracefully
- Designed as a replacement for built-in web_search with a self-hosted engine
Metadata
Frequently Asked Questions
What is local-search-pro?
Free Brave API alternative for OpenClaw. Completely FREE web search. No API key required. Secure localhost-only deployment. Supports hidden --dev flag for lo... It is an AI Agent Skill for Claude Code / OpenClaw, with 376 downloads so far.
How do I install local-search-pro?
Run "/install local-search-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is local-search-pro free?
Yes, local-search-pro is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does local-search-pro support?
local-search-pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created local-search-pro?
It is built and maintained by pipe (@pipepi); the current version is v1.0.10.
More Skills