Searxng Search Skill

What This Skill Does

The Searxng Search Skill, authored by elmaslouhymouaad, provides a powerful and privacy-centric interface for the SearXNG metasearch engine directly within the OpenClaw environment. By acting as a bridge between the agent and a SearXNG instance, this skill allows users to aggregate search results from dozens of search engines simultaneously without tracking or profiling. It features robust integration with retry logic, configurable timeout handling, and support for specialized search categories such as news, science, images, and videos. Whether you are running a local instance for maximum privacy or connecting to a public node, this skill ensures consistent, high-quality data retrieval for your AI-driven workflows.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/elmaslouhymouaad/searxng-search-skill

Ensure that you have the necessary dependencies installed, which include requests, urllib3, and python-dotenv. You can configure the skill by creating a .env file in your root directory with your SEARXNG_URL and preferred timeout settings. For source-based installations, you can also use pip install -e . to maintain a development environment.

Use Cases

This skill is indispensable for research-heavy tasks. It excels in gathering cross-platform information for competitive analysis, sentiment tracking, or technical documentation gathering. By utilizing the time-range filters, users can specifically query for current events or historical data. It is also highly effective for media acquisition, allowing agents to fetch direct image sources or video details for automated content curation. Its privacy-first design makes it an excellent choice for agents operating in secure environments where data leakage must be minimized.

Example Prompts

1. "Perform a search for the latest AI regulation news from the last week and summarize the main points for me."
2. "Find high-quality images of mountain landscapes with strict safe-search settings and return the source URLs."
3. "Search for 'Python best practices' and filter the results specifically to technical science and development articles."

Tips & Limitations

Always prioritize using a private or trusted SearXNG instance to ensure your queries are not logged by external providers. While the skill supports extensive customization, keep in mind that excessive querying with very short retry intervals can lead to temporary rate-limiting by the underlying search engines. We recommend tuning your SEARXNG_BACKOFF_FACTOR in the configuration file if you encounter connection drops during high-frequency usage. Note that results are limited to the availability and responsiveness of the chosen SearXNG instance.