# Searxng Search

> Web search using SearXNG instance via MCP. Provides web search capability for agents with configurable SearXNG endpoint.

- Skill: `kbarbel640-del/searxng-search` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/searxng-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/searxng-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/searxng-search

---


# SearXNG Search

Web search using SearXNG instance via MCP protocol.

## Features

- 🔍 Web search with multiple result formats
- 🔧 MCP server for standard tool integration
- ⚙️ Configurable SearXNG endpoint
- 📊 JSON, Markdown, and text output formats

## Configuration

Set your SearXNG URL:

```bash
export SEARXNG_URL="http://your-searxng-instance:port"
```

Or configure in mcporter:

```json
{
  "mcpServers": {
    "searxng": {
      "command": "python3",
      "args": ["./mcp-server.py"],
      "env": {
        "SEARXNG_URL": "http://your-searxng-instance:port"
      }
    }
  }
}
```

## Installation

### 1. Configure MCP Server

Copy `config.json` to your mcporter config:

```bash
cp config.json ~/.config/mcporter/config.json
```

### 2. Install mcporter

```bash
npm install -g mcporter
```

## Usage

### Via mcporter

```bash
# List servers
mcporter list

# Search web
mcporter call searxng.web_search query="OpenClaw features" limit=5
```

### Via Script

```bash
# Configure first
export SEARXNG_URL="http://your-searxng-instance:port"

# Basic search
./searxng_search.sh "your search query"

# With options
./searxng_search.sh "query" --limit 5 --format markdown
```

### Direct API

```bash
curl "${SEARXNG_URL}/search?q=OpenClaw&format=json"
```

## Output Formats

- `text` (default): Human-readable format
- `json`: Raw JSON output
- `markdown`: Markdown formatted results

## Files

- `mcp-server.py` - MCP server implementation
- `searxng_search.sh` - Bash search script
- `config.json` - MCP configuration template

## Requirements

- Python 3.8+
- mcporter CLI
- curl, jq (for bash script)

## Author

zfanmy-梦月儿