ClawSearchBridge

Bridge service to expose SearXNG search results in a simple JSON format for OpenClaw workflows.

Why this exists

OpenClaw built-in web_search currently supports providers like Brave/Perplexity/Gemini. SearXNG is not a native provider, so this bridge translates SearXNG responses to a stable JSON shape.

Endpoints

• GET /healthz
• GET /search?q=<query>&count=5&lang=en

Response shape:

{
  "ok": true,
  "provider": "searxng",
  "query": "...",
  "count": 5,
  "results": [
    { "title": "...", "url": "...", "description": "..." }
  ]
}

Run

cd /home/kyaky/projects/ClawSearchBridge
cp .env.example .env
export $(grep -v '^#' .env | xargs)
npm run start

Environment

• PORT (default: 18100)
• SEARXNG_BASE_URL (default: http://127.0.0.1:18080)
• DEFAULT_COUNT (default: 5, max 10)
• REQUEST_TIMEOUT_MS (default: 15000)

Notes

• This project assumes SearXNG is reachable at SEARXNG_BASE_URL.
• Keep bridge and searxng on loopback unless you explicitly need remote access.