Searxng Search

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

Security Scan

The skill's code matches its stated purpose (proxying searches to a SearxNG instance), but the registry metadata omits required binaries and the required SEARXNG_URL environment variable declared and used in the SKILL.md and code — an inconsistency you should resolve before trusting installation.

Purpose & Capability

The skill's files (mcp-server.py and searxng_search.sh) implement exactly what the description says: calling a SearxNG instance and exposing it via an MCP server or script. However, the registry metadata lists no required binaries or env vars while SKILL.md and the code require python3, curl, jq and the SEARXNG_URL environment variable. That metadata mismatch is an incoherence to investigate.

Instruction Scope

SKILL.md instructs only to set SEARXNG_URL, copy config.json into mcporter config, install mcporter, and run the provided server/script. The runtime instructions and code read only SEARXNG_URL and perform HTTP requests to the configured SearxNG endpoint; they do not attempt to read arbitrary local files or other environment variables.

Install Mechanism

There is no automated install spec (instruction-only), so nothing arbitrary is downloaded or written by an installer. The only external install command suggested is 'npm install -g mcporter' for the MCP runtime, which is reasonable for this integration.

Credentials

The actual code requires a single environment variable SEARXNG_URL (and the SKILL.md lists required binaries), but the registry metadata declares no required env vars or binaries. This omission is disproportionate to the packaging information and could lead users to install without providing or understanding the external endpoint to which queries will be sent.

Persistence & Privilege

The skill does not request always:true or other elevated persistence. It runs as a normal MCP server or script and does not modify other skills or global agent settings.

What to consider before installing

This package appears to implement a straightforward SearxNG search wrapper, but the registry metadata is missing required binaries and the SEARXNG_URL environment variable that the code expects. Before installing: - Confirm the SEARXNG_URL you will use and that it points to a trusted SearxNG instance (your search queries will be sent to that endpoint). - Verify locally that the included files (mcp-server.py and searxng_search.sh) are the code you expect; they are readable and do not contain obfuscated or hidden network endpoints. - If you require metadata accuracy, ask the publisher to update the registry entry to declare required binaries (python3, curl, jq) and the SEARXNG_URL env var. - Run the server/script in a sandbox or with restricted network access if you are unsure about exposing queries externally. - If you plan to use this in automated agent runs, ensure the MCP integration and SEARXNG_URL do not inadvertently expose private or sensitive data to the configured SearxNG instance. If the metadata mismatch was accidental, the skill itself is coherent with its stated purpose; if the omission was intentional, treat it as a red flag and avoid installing until clarified.

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:

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

Or configure in mcporter:

{
  "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:

cp config.json ~/.config/mcporter/config.json

2. Install mcporter

npm install -g mcporter

Usage

Via mcporter

# List servers
mcporter list

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

Via Script

# 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

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-梦月儿