searxng-search

Queries SearXNG meta-search instances via JSON API to aggregate results from 70+ search engines.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill searxng-search-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/optional-skills/research/searxng-search
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill searxng-search-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free web search without an API key by querying a self-hosted or public SearXNG instance, and serves as an automatic fallback when the primary web search toolset is unavailable. ## Core Features & Use Cases - Meta-Search Aggregation: Query 70+ search engines simultaneously through a single SearXNG JSON API endpoint. - Flexible Filtering: Control engines, categories, safesearch level, time range, and result limits via query parameters. - Self-Hosting Support: Run your own SearXNG instance with Docker or pip to avoid rate limits and public instance downtime. - Use Case: When the main web search toolset lacks a FIRECRAWL_API_KEY, set SEARXNG_URL to a public instance and search for recent AI news filtered by the news category and week time range. ## Quick Start Set the SEARXNG_URL environment variable to a SearXNG instance and ask the agent to search the web for a topic using SearXNG.

Frequently Asked Questions about searxng-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web with SearXNG using curl?▼

Call the SearXNG search endpoint with curl using the q, format=json, engines, and limit query parameters against your SEARXNG_URL. Always set --max-time to avoid hanging on unreachable instances and URL-encode the query string.

Does SearXNG search require an API key?▼

No API key is required when using a public SearXNG instance. You only need to set the SEARXNG_URL environment variable pointing to a public or self-hosted instance to start querying.

How do I self-host a SearXNG instance with Docker?▼

Run docker run -d -p 8888:8080 with the searxng/searxng image and a settings volume, then set SEARXNG_URL=http://localhost:8888. Self-hosting avoids public instance rate limits and downtime.

Why does SearXNG search return empty results?▼

Empty results usually mean the instance blocks the query, is unreachable, or has the requested engines disabled. Verify SEARXNG_URL is set and reachable with a test curl request, or switch to another instance.

Can SearXNG extract full page content from search results?▼

No, SearXNG returns only titles, URLs, and snippets. To get full page content, search first and then extract the most relevant URL using web_extract, browser tools, or curl.