# Searxng Search

> Search the web using the local SearXNG instance running on http://localhost:8080. Use as the primary web search tool; fall back to other search methods if SearXNG is unavailable. WHEN: web search, search the web, look up documentation, find information online, SearXNG, local search.

- Skill: `elodhorvath/searxng-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add elodhorvath/searxng-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/elodhorvath/searxng-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: elodhorvath (https://skillmd.com/u/elodhorvath)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/elodhorvath/searxng-search

---


# SearXNG Local Search

> Use the local SearXNG instance at `http://localhost:8080` as the **primary** web search tool.

## Triggers

Activate this skill when the user asks to:
- Search the web
- Look up documentation
- Find information online
- Use SearXNG
- Perform a local web search

## Rules

1. **Primary search tool** — Always try SearXNG first for web search.
2. **Default endpoint** — Use `http://localhost:8080` unless the user specifies another SearXNG endpoint.
3. **Auto-start if down** — If SearXNG is not running, attempt to start the existing Docker container named `Searxng_my_eyeballs` (image: `searxng/searxng:latest`). If the container name changes, update the script or ask the user.
4. **Fallback** — If SearXNG cannot be reached or started, fall back to other available search tools/APIs and tell the user.
5. **Format results** — Summarize the top results concisely with titles, URLs, and relevant snippets.

## Usage

### Basic search

```bash
curl -s "http://localhost:8080/search?q=QUERY&format=json" | jq '.results[:5] | {title, url, content}'
```

### Search with category

```bash
curl -s "http://localhost:8080/search?q=QUERY&category_general=on&format=json" | jq '.results[:5]'
```

### Start SearXNG container if not running

```bash
docker start Searxng_my_eyeballs
```

### Check if SearXNG is running

```bash
curl -s -o /dev/null -w "%{http_code}" http://localhost:8080
```

## Response Format

When returning search results, present them as a markdown list:

- **[Title](url)** — Snippet or summary.
- **[Title](url)** — Snippet or summary.

If no useful results are found, say so explicitly.