Agent skill · research science · sundial-org
searxng-web-search
Search the web using SearXNG. Use when you need current information, research topics, find documentation, verify facts, or look up anything beyond your knowledge. Returns ranked results with titles, URLs, and content snippets.
Why this skill is useful
Provides a specific implementation for querying a SearXNG instance with error handling and rate limiting that the AI wouldn't generate on its own.
What it needs
Requires babashka installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
SearXNG Web Search Search the web using a self-hosted SearXNG instance. This skill provides access to web search results through the SearXNG JSON API, with built-in rate limiting, error handling, and result formatting. When to Use Use this skill when you need to: Find current information or recent news Research topics beyond your knowledge cutoff Look up documentation or technical references Verify facts or check current status Find URLs or resources on specific topics Search for code examples or solutions Configuration Set the SEARXNGURL environment variable to your SearXNG instance: Or use the default (http://localhost:8888) if not set. Usage Execute the search script with your query: Advanced Options Pass additional parameters as JSON: Available options: category - Filter by category: general, news, images, videos, it, science timerange - Time filter: day, week, month, year language - Language code (default: en) numresults - Number of results to return (default: 5) Output Format The script returns formatted search results as text: Error Handling The script handles common errors gracefully: Network timeouts (30s timeout) SearXNG unavailable (clear error message) Invalid queries (error details) Rate limiting (429 responses) Empty results (informative message) Rate Limiting The script implements basic rate limiting: Minimum 1 second between requests Uses filesystem-based state (.searxng-last-request) Prevents accidental spam Examples Basic Search News Search Technical Search Recent Results Only Troubleshooting "SEARXNGURL not set" Set the environment variable: export SEARXNGURL="http://localhost:8888" Connection timeout Check that SearXNG is running: curl $SEARXNGURL/search?q=test&format=json Verify firewall settings Check service status: systemctl status searx Empty results Try a broader query Remove filters and try again Check SearXNG logs: journalctl -u searx -n 50 Rate limit errors Wait a few seconds between searches The script enforces minimum 1s delay automati …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/searxng-web-search