| name | searxng-cli |
| description | Use for web search and content extraction when you want a free, unlimited, local solution. Priority: native websearch (simple) → searxng (comprehensive, free) → tavily (advanced features). Use when: user wants comprehensive results without API keys, mentions "free", "unlimited", "local", "SearXNG", "no API key", or searxng-docker-tavily-adapter stack is running. Falls back to tavily if advanced features needed (research synthesis, JS rendering).
|
| compatibility | Requires searxng-docker-tavily-adapter Docker stack running on localhost:8000 |
| allowed-tools | Bash(curl *) |
SearXNG CLI (Tavily-Compatible)
Free, unlimited web search and content extraction via local Docker. No API key required.
Prerequisites
Requires searxng-docker-tavily-adapter running locally.
curl -s http://localhost:8000/health
If not running, ask user for permission to set up:
git clone https://github.com/vakovalskii/searxng-docker-tavily-adapter
cd searxng-docker-tavily-adapter
cp config.example.yaml config.yaml
python -c "import secrets; print(secrets.token_urlsafe(32))"
docker compose up -d
Or start existing stack: docker compose up -d
Workflow
| Need | Endpoint | When |
|---|
| Find pages on a topic | /search | No specific URL yet |
| Get a page's content | /search + include_raw_content | Have a URL |
Endpoints
- Search:
http://localhost:8000/search
- Health:
http://localhost:8000/health
- SearXNG UI:
http://localhost:8999
Quick start
curl -X POST "http://localhost:8000/search" \
-H "Content-Type: application/json" \
-d '{"query": "your query", "max_results": 5}'
Python (drop-in Tavily replacement)
from tavily import TavilyClient
client = TavilyClient(api_key="ignored", base_url="http://localhost:8000")
response = client.search(query="your query", max_results=5, include_raw_content=True)
Advantages over Tavily
| Tavily | SearXNG Adapter |
|---|
| Paid | Free |
| API key required | No keys |
| Rate limits | No limits |
| External service | Local deployment |
Limitations
- No AI-powered research synthesis → use tavily-research
- No advanced search filters (topic, time range) → use tavily-search
- No JavaScript rendering → use tavily-extract with
--extract-depth advanced
See also
