ask-searxng-search

Configure and troubleshoot a private SearXNG metasearch instance for agent search backends.

74|11|Updated Jul 4, 2024
One-click install
npx skills add https://github.com/OpenSourceAGI/qwksearch-research-agent --skill ask-searxng-search-opensourceagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ask-searxng-search
Source: https://github.com/OpenSourceAGI/qwksearch-research-agent/tree/main/skills/ask-searxng-search
Command: npx skills add https://github.com/OpenSourceAGI/qwksearch-research-agent --skill ask-searxng-search-opensourceagi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Standing up a private SearXNG metasearch instance for programmatic agent search involves non-obvious configuration: stock SearXNG serves HTML only, settings are baked into the Docker image at build time, and engine names differ between components. This Skill documents the exact settings, Dockerfiles, and failure modes so the instance works as a JSON search backend. ## Core Features & Use Cases - Settings guidance: Explains searxng-settings.yml essentials including JSON output format, secret key generation, limiter behavior, and Redis/valkey caching. - Deployment recipes: Covers the dev Dockerfile, the Redis-backed Dockerfile.redis variant, local docker run commands, and Render.com deployment. - Agent integration: Clarifies how chat-agent-toolkit's searchSearxng consumes the instance and why MetaSearchAgent engine names use spaces instead of underscores. - Troubleshooting table: Maps symptoms like 403 on format=json, ignored settings edits, and rate limiting to concrete fixes. - Use Case: Your agent's SearXNG endpoint returns 403 instead of JSON; use this Skill to identify that json is missing from search.formats and redeploy with the correct settings file. ## Quick Start Ask the assistant to explain why your SearXNG instance returns 403 on JSON requests and how to fix the settings file.

Frequently Asked Questions about ask-searxng-search

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

FAQPage Schema
Why does SearXNG return 403 instead of JSON?

SearXNG returns 403 on format=json requests when json is missing from search.formats in the settings file. Stock SearXNG serves HTML only, so you must add json to the formats list and redeploy the settings.

How do I deploy a private SearXNG instance with Docker?

Build the provided Dockerfile with docker build, then run it with port 8080 exposed and SEARXNG_BASE_URL set to your origin. For production, use Dockerfile.redis with a Redis or valkey backend and raise UWSGI_WORKERS and UWSGI_THREADS.

Why do my SearXNG settings changes have no effect?

The settings file is copied into the image at build time via COPY, so a running container never sees edits. Rebuild the image after changing searxng-settings.yml, or bind-mount the file into the container instead.

How do I enable or disable a SearXNG search engine?

Flip the disabled flag on the engine's entry in the engines YAML file and rebuild the Docker image. Engines fail independently, so check the SearXNG stats page if one consistently returns nothing.

Why does my agent get rate limited by its own SearXNG instance?

The limiter setting is enabled, which throttles callers including your own agent. For a private instance set limiter to false; if you keep it true for a public instance, whitelist your caller or expect 429 responses.