searxng-search

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill searxng-search-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/research/searxng-search
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill searxng-search-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free, keyless web search when no paid search API key (like FIRECRAWL_API_KEY) is configured, by querying a public or self-hosted SearXNG instance that aggregates 70+ search engines. ## Core Features & Use Cases - Keyless Meta-Search: Query SearXNG's JSON API via curl or Python requests with no API key required on public instances. - Flexible Filtering: Filter results by engines, categories, safesearch level, time range, and result limits. - Self-Hosting Support: Run your own SearXNG instance via Docker or pip for full control and no rate limits. - Use Case: When the main web search toolset is unavailable, search for "fastapi deployment guide" across Google and Bing simultaneously, then extract the best URL with web_extract for full page content. ## Quick Start Set the SEARXNG_URL environment variable to a public or self-hosted instance, then 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 without an API key?▼

Use SearXNG, a free meta-search aggregator that queries 70+ engines with no API key on public instances. Set the SEARXNG_URL environment variable to a public instance and call its /search endpoint with format=json via curl or Python requests.

How to query the SearXNG API with curl?▼

Call ${SEARXNG_URL}/search with parameters q (URL-encoded query), format=json, and optional engines, limit, categories, safesearch, and time_range flags. Always use --max-time to avoid hanging on unreachable instances.

Can I self-host SearXNG with Docker?▼

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

Does SearXNG return full page content?▼

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

Why does SearXNG search return empty results?▼

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